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.