KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

String.indexOf — een substring zoeken

String.indexOf geeft de index van de eerste overeenkomst met een substring terug, of -1. Met de parameter fromIndex kun je de zoekactie op een opgegeven positie laten beginnen.

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

Syntax

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

String.indexOf(str) vindt de eerste overeenkomst met de substring; String.indexOf(str, fromIndex) zoekt vanaf fromIndex, inclusief. Het resultaat is een index vanaf nul in de volledige string, of -1. Controleer position >= 0, niet position > 0: positie 0 is een geldige overeenkomst.

De zoekactie is letterlijk, hoofdlettergevoelig en interpreteert geen reguliere expressies. Indexen tellen UTF-16-code-eenheden (char), die niet noodzakelijk overeenkomen met volledige Unicode-tekens. Een negatieve fromIndex werkt als 0; bij een niet-lege str levert een index voorbij de stringlengte -1 op. Een index buiten het bereik veroorzaakt op zichzelf geen uitzondering.

Bij een lege str is het resultaat Math.min(Math.max(fromIndex, 0), text.length()). Een null-argument voor str veroorzaakt een NullPointerException. Begin na een geslaagde overeenkomst bij position + 1 om de volgende, mogelijk overlappende overeenkomst van een niet-lege substring te vinden.

Voorbeelden

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

Resultaat

1
3
-1
6

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen