KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

`Matcher.matches()`: het hele bereik testen in Java

`Matcher.matches()` controleert of een reguliere expressie overeenkomt met het hele huidige bereik, niet slechts met een deel ervan. Standaard omvat het bereik de volledige invoer.

Versie: Java SE 21

Syntax

public boolean matches()

Matcher.matches() is een instantiemethode zonder argumenten van java.util.regex.Matcher. Compileer de reguliere expressie met Pattern.compile(regex), maak een Matcher met pattern.matcher(input) en roep matcher.matches() aan. De methode geeft alleen true terug als het patroon overeenkomt met het hele huidige bereik; anders geeft ze false terug.

Standaard omvat het bereik de volledige invoer. Stel de grenzen in met region(start, end): start telt mee en end niet. Daarna vereist matches() dat het hele geselecteerde bereik overeenkomt, niet de hele oorspronkelijke invoer. Je hoeft geen ^ en $ toe te voegen om een overeenkomst over het hele bereik af te dwingen.

Gebruik lookingAt() als een overeenkomst aan het begin van het bereik volstaat, of find() om het volgende passende fragment in het bereik te zoeken. Geeft matches() de waarde true terug, dan geeft group() de overeenkomende tekst en geven start() en end() de bijbehorende indices in de invoer: begin inclusief, einde exclusief. Na false werpen deze drie methoden IllegalStateException op als je ze vóór een nieuwe geslaagde match aanroept.

Voorbeelden

import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Main {
    public static void main(String[] args) {
        Pattern fourDigits = Pattern.compile("[0-9]{4}");
        String input = "id=1234!";

        System.out.println(fourDigits.matcher(input).matches());
        System.out.println(fourDigits.matcher(input).find());
        System.out.println(fourDigits.matcher("1234!").lookingAt());

        Matcher selected = fourDigits.matcher(input).region(3, 7);
        boolean matched = selected.matches();
        System.out.println(matched);
        if (matched) {
            System.out.println(selected.group());
        }
    }
}

Resultaat

false
true
true
true
1234

Het patroon `[0-9]{4}` vereist precies vier ASCII-cijfers. De volledige tekenreeks `id=1234!` komt niet overeen, maar `find()` vindt `1234`. Bij `1234!` vindt `lookingAt()` een overeenkomst aan het begin. Bereik `[3, 7)` van `id=1234!` bevat alleen `1234`, dus `matches()` geeft `true` terug en `group()` geeft `1234` terug.

Gerelateerde lessen

  • Java · Les 70 · Basis · Versie: 2

Bronnen