Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.split — dividere il testo con un’espressione regolare

String.split restituisce un array di frammenti di testo separati dalle corrispondenze di un’espressione regolare. Il parametro limit controlla il numero di divisioni e il trattamento degli elementi vuoti finali.

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

Sintassi

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

String.split restituisce un String[] con i frammenti nell’ordine in cui compaiono, senza i separatori corrispondenti. Se non ci sono corrispondenze, il risultato contiene un elemento: l’intero testo di input.

split(regex) equivale a split(regex, 0): gli elementi vuoti finali vengono rimossi. Con limit < 0 vengono mantenuti. Con limit > 0 vengono eseguite al massimo limit - 1 divisioni; l’ultimo elemento contiene il testo rimanente e l’array ha al massimo limit elementi.

regex è un’espressione regolare, non un semplice separatore. Scrivi un punto letterale come "\\."; per proteggere un separatore letterale qualsiasi, usa Pattern.quote(separator) di java.util.regex.Pattern. Un modello non valido genera PatternSyntaxException.

Con limit == 1, il testo non viene diviso, anche se c’è una corrispondenza all’inizio. Se la divisione avviene in corrispondenza di un separatore che consuma caratteri all’inizio del testo, si ottiene un elemento vuoto iniziale. Una corrispondenza di larghezza zero all’inizio non lo produce. Con limit == 0, se tutti gli elementi ottenuti dalla divisione sono vuoti, vengono rimossi tutti, compreso il primo. Ad esempio, ",".split(",", 0) restituisce un array vuoto.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti