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

CKTIS / Java

String.indexOf — rechercher une sous-chaîne

String.indexOf renvoie l’index de la première correspondance d’une sous-chaîne, ou -1. Le paramètre fromIndex permet de commencer la recherche à une position donnée.

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

Syntaxe

int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);

String.indexOf(str) trouve la première correspondance de la sous-chaîne ; String.indexOf(str, fromIndex) lance la recherche à partir de fromIndex, inclus. Le résultat est un index à base zéro dans l’ensemble de la chaîne, ou -1. Vérifiez position >= 0, et non position > 0 : la position 0 correspond à une correspondance valide.

La recherche est littérale, sensible à la casse et n’interprète pas les expressions régulières. Les index comptent les unités de code UTF-16 (char), qui ne correspondent pas nécessairement à des caractères Unicode entiers. Un fromIndex négatif se comporte comme 0 ; si str n’est pas vide, un index supérieur à la longueur de la chaîne renvoie -1. Un index hors limites ne provoque pas à lui seul d’exception.

Si str est vide, le résultat est Math.min(Math.max(fromIndex, 0), text.length()). Un argument null pour str provoque une NullPointerException. Pour trouver la correspondance suivante, éventuellement chevauchante, d’une sous-chaîne non vide, commencez à position + 1 après une correspondance réussie.

Exemples

public class Main {
    public static void main(String[] args) {
        String text = "banana";
        int first = text.indexOf("ana");
        int next = text.indexOf("ana", first + 1);
        System.out.println(first);
        System.out.println(next);
        System.out.println(text.indexOf("ANA"));
        System.out.println(text.indexOf("", 99));
    }
}

Résultat

1
3
-1
6

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