KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.split — tekst splitsen met een reguliere expressie

String.split geeft een array met tekstfragmenten terug, gescheiden door overeenkomsten met een reguliere expressie. De parameter limit bepaalt het aantal splitsingen en hoe lege elementen aan het einde worden behandeld.

Versie: Java SE 21; repository runtime, production runtime not attested

Syntax

String[] parts = text.split(regex);
String[] parts = text.split(regex, limit);

String.split geeft een String[] terug met de fragmenten in de volgorde waarin ze voorkomen, zonder de overeenkomende scheidingstekens. Als er geen overeenkomst is, bevat het resultaat één element: de volledige invoertekst.

split(regex) is gelijk aan split(regex, 0): lege elementen aan het einde worden verwijderd. Bij limit < 0 blijven ze behouden. Bij limit > 0 worden er hoogstens limit - 1 splitsingen uitgevoerd; het laatste element bevat de resterende tekst en de array heeft hoogstens limit elementen.

regex is een reguliere expressie, geen gewoon scheidingsteken. Schrijf een letterlijke punt als "\\."; bescherm een willekeurig letterlijk scheidingsteken met Pattern.quote(separator) uit java.util.regex.Pattern. Een ongeldig patroon veroorzaakt PatternSyntaxException.

Bij limit == 1 wordt de tekst niet gesplitst, ook niet als het patroon aan het begin overeenkomt. Als de methode splitst op een overeenkomst die aan het begin van de tekst tekens verbruikt, ontstaat er vooraan een leeg element. Een overeenkomst met breedte nul aan het begin levert geen leeg element op. Als bij limit == 0 alle door de splitsing ontstane elementen leeg zijn, worden ze allemaal verwijderd, ook het eerste. Zo geeft ",".split(",", 0) een lege array terug.

Voorbeelden

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)));
    }
}

Resultaat

[red, blue]
[red, blue, , ]
[red, blue..]

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen