CKTIS / Java
String.split — razdvajanje teksta regularnim izrazom
String.split vraća polje dijelova teksta razdvojenih podudaranjima regularnog izraza. Parametar limit određuje broj razdvajanja i način obrade praznih elemenata na kraju.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);String.split vraća String[] s dijelovima teksta redom kojim se pojavljuju, bez podudarnih razdjelnika. Ako nema podudaranja, rezultat sadrži jedan element: cijeli ulazni tekst.
split(regex) isto je što i split(regex, 0): prazni elementi na kraju uklanjaju se. Uz limit < 0 zadržavaju se. Uz limit > 0 izvršava se najviše limit - 1 razdvajanja; posljednji element sadrži preostali tekst, a polje ima najviše limit elemenata.
regex je regularni izraz, a ne običan razdjelnik. Doslovnu točku zapiši kao "\\."; bilo koji doslovni razdjelnik zaštiti pomoću Pattern.quote(separator) iz java.util.regex.Pattern. Neispravan uzorak uzrokuje PatternSyntaxException.
Uz limit == 1 tekst se ne razdvaja, čak ni ako se uzorak podudara na početku. Ako se tekst razdvoji na mjestu podudaranja koje obuhvaća znakove na početku teksta, nastaje početni prazni element. Podudaranje nulte širine na početku ne stvara takav element. Ako su uz limit == 0 svi elementi nastali razdvajanjem prazni, uklanjaju se svi, uključujući i prvi. Primjerice, ",".split(",", 0) vraća prazno polje.
Primjeri
import java.util.Arrays;
public class Main {
public static void main(String[] args) {
String text = "red.blue..";
System.out.println(Arrays.toString(text.split("\\.")));
System.out.println(Arrays.toString(text.split("\\.", -1)));
System.out.println(Arrays.toString(text.split("\\.", 2)));
}
}Rezultat
[red, blue] [red, blue, , ] [red, blue..]
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.