CKTIS / Java
Matcher — tekst controleren en overeenkomsten uitlezen
java.util.regex.Matcher past een reguliere expressie toe op tekst. matches() controleert de hele regio, find() zoekt opeenvolgende overeenkomende deelreeksen en group() leest het resultaat van een geslaagde overeenkomst uit.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Pattern pattern = Pattern.compile(regex);
Matcher matcher = pattern.matcher(input);
boolean whole = matcher.matches();
matcher.reset();
while (matcher.find()) {
String match = matcher.group();
// groupCount() counts capturing groups in the pattern, excluding group 0.
// This guard checks that group 1 exists, not that it participated in the match.
if (matcher.groupCount() >= 1) {
String captured = matcher.group(1);
}
}java.util.regex.Matcher vergelijkt een Pattern met tekst. Maak er een met pattern.matcher(input). Het object bewaart de zoekstatus; deel het niet tussen meerdere threads.
Matcher.matches() controleert de hele huidige regio, die standaard de volledige invoer omvat. Matcher.find() zoekt de volgende overeenkomende deelreeks; herhaalde aanroepen zetten de zoekactie voort. Beide methoden geven boolean terug. reset() wist de overeenkomststatus en herstelt de regio zodat die de volledige invoer omvat.
Matcher.group() en group(0) geven de volledige overeenkomst terug. Vastleggroepen worden vanaf 1 genummerd in de volgorde van de openende haakjes: group(1) leest de eerste uit. Lees een benoemde groep uit met group("name"). Een optionele groep die niet heeft meegedaan, geeft null terug; een groep die overeenkomt met lege tekst geeft "" terug.
Lees groepen uit nadat het resultaat true is: vóór een overeenkomstpoging of na een mislukte poging gooit group() een IllegalStateException. In het voorbeeld geeft matches() false terug, omdat het patroon niet de volledige invoer omvat. Na reset() leest de find()-lus twee overeenkomsten en hun groepen uit.
Voorbeelden
import java.util.regex.Matcher;
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
Pattern pattern = Pattern.compile("([A-Z]+)-([0-9]+)");
Matcher matcher = pattern.matcher("AB-12 CD-7");
System.out.println("matches=" + matcher.matches());
matcher.reset();
while (matcher.find()) {
System.out.println(matcher.group() + " | "
+ matcher.group(1) + " | " + matcher.group(2));
}
}
}Resultaat
matches=false AB-12 | AB | 12 CD-7 | CD | 7
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.