CKTIS / Java
String.split — razdelitev besedila z regularnim izrazom
String.split vrne polje besedilnih delov, ločenih z zadetki regularnega izraza. Parameter limit določa število razdelitev in obravnavo praznih elementov na koncu.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);String.split vrne String[] z deli besedila v vrstnem redu, v katerem se pojavijo, brez ustreznih ločil. Če ni zadetkov, rezultat vsebuje en element: celotno vhodno besedilo.
split(regex) pomeni enako kot split(regex, 0): prazni elementi na koncu se odstranijo. Pri limit < 0 se ohranijo. Pri limit > 0 se izvede največ limit - 1 razdelitev; zadnji element vsebuje preostalo besedilo, polje pa ima največ limit elementov.
regex je regularni izraz, ne navadno ločilo. Dobesedno piko zapiši kot "\\."; poljubno dobesedno ločilo zaščiti z Pattern.quote(separator) iz java.util.regex.Pattern. Neveljaven vzorec sproži PatternSyntaxException.
Pri limit == 1 se besedilo ne razdeli, tudi če se vzorec ujema na začetku. Če se besedilo razdeli na mestu zadetka, ki na začetku besedila porabi znake, nastane začetni prazen element. Zadetek ničelne širine na začetku ga ne ustvari. Če so pri limit == 0 vsi elementi, nastali pri razdelitvi, prazni, se odstranijo vsi, tudi prvi. Na primer, ",".split(",", 0) vrne prazno polje.
Primeri
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..]
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.