Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.substring — estrarre una parte di una stringa

String.substring restituisce una parte di una stringa senza modificare l’originale. L’inizio è incluso e la fine esclusa; gli indici contano unità di codice UTF-16.

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

Sintassi

String substring(int beginIndex)
String substring(int beginIndex, int endIndex)

String.substring(beginIndex, endIndex) restituisce l’intervallo [beginIndex, endIndex), di lunghezza endIndex - beginIndex. Gli indici partono da zero. String.substring(beginIndex) restituisce il suffisso fino alla fine. La stringa originale rimane invariata.

È necessario che valga 0 <= beginIndex <= endIndex <= length(). L’overload con un argomento richiede 0 <= beginIndex <= length(). Limiti non validi causano IndexOutOfBoundsException. Limiti uguali, anche alla fine, producono una stringa vuota.

Gli indici contano unità di codice UTF-16 (char), non necessariamente caratteri Unicode completi. Un limite può dividere una coppia di surrogati; non considerare questi indici come posizioni dei caratteri percepiti dall’utente.

Esempi

public class Main {
    public static void main(String[] args) {
        String text = "abcdef";
        System.out.println(text.substring(1, 4));
        System.out.println(text.substring(4));
        System.out.println(text.substring(6).isEmpty());
        System.out.println(text);
    }
}

Risultato

bcd
ef
true
abcdef

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