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.
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.