CKTIS / Java
String.indexOf — buscar una subcadena
String.indexOf devuelve el índice de la primera coincidencia de una subcadena o -1. El parámetro fromIndex permite empezar la búsqueda en una posición indicada.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
int position = text.indexOf(str);
int positionFromIndex = text.indexOf(str, fromIndex);String.indexOf(str) encuentra la primera coincidencia de la subcadena; String.indexOf(str, fromIndex) busca a partir de fromIndex, inclusive. El resultado es un índice basado en cero dentro de toda la cadena, o -1. Comprueba position >= 0, no position > 0: la posición 0 es una coincidencia válida.
La búsqueda es literal, distingue entre mayúsculas y minúsculas y no interpreta expresiones regulares. Los índices cuentan unidades de código UTF-16 (char), que no siempre equivalen a caracteres Unicode completos. Un fromIndex negativo funciona como 0; si str no está vacío, un índice superior a la longitud de la cadena devuelve -1. Un índice fuera de rango no provoca por sí solo una excepción.
Si str está vacío, el resultado es Math.min(Math.max(fromIndex, 0), text.length()). Un argumento null para str provoca una NullPointerException. Para encontrar la siguiente coincidencia, que puede solaparse, de una subcadena no vacía, empieza en position + 1 después de una coincidencia correcta.
Ejemplos
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));
}
}Resultado
1 3 -1 6
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.