CKTIS / Java
String.split — rozdělení textu regulárním výrazem
String.split vrací pole částí textu oddělených shodami regulárního výrazu. Parametr limit určuje počet rozdělení a způsob zacházení s prázdnými prvky na konci.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);String.split vrací String[] s částmi textu v pořadí, v jakém se vyskytují, bez odpovídajících oddělovačů. Pokud se nenajde žádná shoda, výsledek obsahuje jeden prvek: celý vstupní text.
split(regex) znamená totéž co split(regex, 0): prázdné prvky na konci se odstraní. Při limit < 0 se zachovají. Při limit > 0 se provede nejvýše limit - 1 rozdělení; poslední prvek obsahuje zbytek textu a pole má nejvýše limit prvků.
regex je regulární výraz, nikoli obyčejný oddělovač. Doslovnou tečku zapište jako "\\."; libovolný doslovný oddělovač ošetřete pomocí Pattern.quote(separator) z java.util.regex.Pattern. Neplatný vzor vyvolá PatternSyntaxException.
Při limit == 1 se text nerozdělí, ani když vzor najde shodu na začátku. Pokud se text rozdělí v místě shody, která na jeho začátku spotřebuje znaky, vznikne úvodní prázdný prvek. Shoda s nulovou šířkou na začátku jej nevytvoří. Při limit == 0 se v případě, že jsou všechny prvky vzniklé rozdělením prázdné, odstraní všechny včetně prvního. Například ",".split(",", 0) vrátí prázdné pole.
Příklady
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)));
}
}Výsledek
[red, blue] [red, blue, , ] [red, blue..]
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.