CKTIS / Java
String.matches: testen of een hele tekenreeks aan een reguliere expressie voldoet
Test of de hele tekenreeks bij een reguliere expressie past. Leer wat `(?s)` voor de punt doet, welke tekenklassen standaard ASCII gebruiken en hoe je backslashes in Java-tekenreeksliteralen schrijft.
Versie: Java SE 21
Syntax
public boolean matches(String regex)String.matches is een instantiemethode van java.lang.String. De aanroep text.matches(regex) interpreteert het argument als een reguliere expressie en geeft alleen true terug als de hele text overeenkomt, niet slechts een deel ervan. De ankers ^ en $ zijn niet nodig. Zoek naar een overeenkomende deelreeks met Pattern.compile(regex).matcher(text).find().
Zet (?s) aan het begin van het patroon om DOTALL in te schakelen: . komt dan ook overeen met regeleindetekens. Standaard komen die niet overeen met de punt. Verwar (?s) niet met (?m): MULTILINE verandert de werking van de ankers ^ en $, niet die van de punt.
In een reguliere expressie staat [A-Z] voor de ASCII-hoofdletters van A tot en met Z. Standaard betekent \d hetzelfde als [0-9] en \w hetzelfde als [a-zA-Z_0-9]. De vlag (?U) (UNICODE_CHARACTER_CLASS) schakelt de Unicode-varianten van deze voorgedefinieerde klassen in, maar breidt het expliciete bereik [A-Z] niet uit.
Java-tekenreeksliteralen en reguliere expressies worden apart geïnterpreteerd. Schrijf "\\d" om \d aan de regex-engine door te geven, en "\\." om \. door te geven en een letterlijke punt te herkennen. Een ongeldig patroon veroorzaakt PatternSyntaxException en een null-argument veroorzaakt NullPointerException; in geen van beide gevallen geeft de methode false terug. Compileer een patroon dat je vaker gebruikt één keer met Pattern.compile(regex) en roep voor elke tekenreeks pattern.matcher(text).matches() aan.
Voorbeelden
import java.util.regex.Pattern;
public class Main {
public static void main(String[] args) {
String code = "[A-Z]{2}\\.\\d{2}";
String withPrefix = "XAB.42";
String nonAsciiDigits = "AB.\u0664\u0662";
String twoLines = "start\nend";
System.out.println("whole: " + "AB.42".matches(code));
System.out.println("prefixed whole: " + withPrefix.matches(code));
System.out.println("prefixed find: " + Pattern.compile(code).matcher(withPrefix).find());
System.out.println("wrong separator: " + "AB-42".matches(code));
System.out.println("default digits: " + nonAsciiDigits.matches(code));
System.out.println("Unicode digits: " + nonAsciiDigits.matches("(?U)" + code));
System.out.println("default dot: " + twoLines.matches("start.*end"));
System.out.println("DOTALL dot: " + twoLines.matches("(?s)start.*end"));
}
}Resultaat
whole: true prefixed whole: false prefixed find: true wrong separator: false default digits: false Unicode digits: true default dot: false DOTALL dot: true
`AB.42` komt volledig overeen, terwijl `find()` in `XAB.42` een overeenkomende deelreeks vindt. Het koppelteken kan de letterlijke punt niet vervangen. De Arabisch-Indische cijfers worden alleen met `(?U)` herkend en de punt herkent het regeleinde alleen met `(?s)`.
Gerelateerde lessen
- Java · Les 1 · Gemiddeld · Versie: 2