Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

String.substring — extraire une partie d’une chaîne

String.substring renvoie une partie d’une chaîne sans modifier l’originale. Le début est inclus et la fin exclue ; les indices comptent des unités de code UTF-16.

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

Syntaxe

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

String.substring(beginIndex, endIndex) renvoie la plage [beginIndex, endIndex), de longueur endIndex - beginIndex. Les indices commencent à zéro. String.substring(beginIndex) renvoie le suffixe jusqu’à la fin. La chaîne originale reste inchangée.

Il faut respecter 0 <= beginIndex <= endIndex <= length(). La surcharge à un argument exige 0 <= beginIndex <= length(). Des bornes invalides provoquent IndexOutOfBoundsException. Des bornes égales, y compris à la fin, produisent une chaîne vide.

Les indices comptent des unités de code UTF-16 (char), pas nécessairement des caractères Unicode complets. Une limite peut couper une paire de substituts ; ne considérez pas ces indices comme des positions de caractères perçus par l’utilisateur.

Exemples

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

Résultat

bcd
ef
true
abcdef

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources