Java Reference Library →

String split() method - Syntax and Examples

String split() method - Syntax and Examples

Java String split() method - Syntax and Examples

This reference explains String split() method - Syntax and Examples through its syntax, examples and boundaries. Use the linked course lessons when the surrounding Java concepts are unfamiliar.

  1. Use this reference

    Identify the documented behavior, read a complete example and check its inputs before applying it.

String split() method - Syntax and Examples

The split() method in Java is a powerful tool for breaking down strings into smaller pieces based on a defined delimiter. Think of it like cutting a cake - you use a knife (the delimiter) to separate the cake (your string) into slices (substrings).

Syntax

public String[] split(String regex)
public String[] split(String regex, int limit)

Parameters

Parameter Description
regex The regular expression that defines the delimiter. This is what the string will be split on.
limit An optional parameter specifying the maximum number of substrings to return. If limit is provided and less than the number of potential splits, then the last substring will contain the remainder of the string.

Return Value

The split() method returns an array of strings, where each element represents a substring that was separated by the delimiter.

Examples

Splitting with a Simple Delimiter

This example demonstrates how to split a string using a simple comma (,) as the delimiter. We'll take a list of fruits and break it into individual fruit names.

String fruits = "apple,banana,orange,grape";
String[] fruitArray = fruits.split(",");

for (String fruit : fruitArray) {
    System.out.println(fruit);
}
apple
banana
orange
grape

In this code, the split() method divides the string "apple,banana,orange,grape" into four substrings using the comma as a separator. The resulting array fruitArray contains each fruit name.

Splitting with a Space Delimiter

This example shows how to split a string by spaces. Let's say you have a sentence, and you want to get individual words from it.

String sentence = "This is a sample sentence";
String[] words = sentence.split(" ");

for (String word : words) {
    System.out.println(word);
}
This
is
a
sample
sentence

Here, we split the string "This is a sample sentence" using a single space as the delimiter. The resulting array words contains each word in the sentence.

Using Regular Expressions

You can use regular expressions for more complex delimiters. This example splits a string by either a comma or a semicolon. Let’s say you have data separated by both commas and semicolons, and you want to treat them as equivalent separators.

String data = "apple,banana;orange,grape";
String[] items = data.split("[;,]");

for (String item : items) {
    System.out.println(item);
}
apple
banana
orange
grape

The regular expression "[;,]" matches either a comma or a semicolon. The split method divides the string at these two characters, creating an array of individual items.

Limiting the Number of Splits

This example uses the limit parameter to control how many substrings are returned. We'll split a sentence but only get the first two parts.

String longSentence = "This is a very long sample sentence";
String[] firstTwoWords = longSentence.split(" ", 2);

for (String word : firstTwoWords) {
    System.out.println(word);
}
This
is a very long sample sentence

Here, we split the string using space as delimiter and setting limit to 2. The array firstTwoWords will only contain the first two words of the original sentence followed by everything else concatenated into one single string.

Using this reference

Check the example’s types, inputs and documented behavior before copying it into an application. Some APIs require external libraries, files or platform services; consult their setup notes.

Related explanations: Java Data Types - Primitive and Non-Primitive, Java Class - Blueprint of Objects, Exceptions in Java Introduction.

Supporting documentation: Official Java learning guide.

Reference checks are optional and do not count toward course progress.

    Reference library →