Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

String.matches: preverjanje ujemanja celotnega niza z regularnim izrazom

Preveri, ali se celoten niz ujema z regularnim izrazom. Spoznaj, kako `(?s)` spremeni pomen pike, kateri razredi znakov privzeto uporabljajo ASCII in kako v Javinih literalih zapisati poševnice nazaj.

Različica: Java SE 21

Sintaksa

public boolean matches(String regex)

String.matches je metoda primerka razreda java.lang.String. Klic text.matches(regex) obravnava argument kot regularni izraz in vrne true le, če se ujema celoten text, ne le njegov podniz. Sidri ^ in $ nista potrebni. Za iskanje ujemajočega se podniza uporabi Pattern.compile(regex).matcher(text).find().

Na začetek vzorca postavi (?s), da vklopiš način DOTALL: . se potem ujema tudi z znaki za konec vrstice, ki jih privzeto ne zajame. Ne zamenjuj (?s) z (?m): način MULTILINE spremeni delovanje sider ^ in $, ne pa pike.

V regularnem izrazu [A-Z] pomeni obseg velikih črk ASCII od A do Z. Privzeto je \d enakovreden [0-9], \w pa [a-zA-Z_0-9]. Zastavica (?U) (UNICODE_CHARACTER_CLASS) vklopi različice teh vnaprej določenih razredov po standardu Unicode, vendar ne razširi izrecnega obsega [A-Z].

Nizovni literali v Javi in regularni izrazi se obdelujejo ločeno. Zapiši "\\d", da mehanizmu za regularne izraze posreduješ \d, in "\\.", da mu posreduješ \. in se vzorec ujema z dobesedno piko. Neveljaven vzorec sproži PatternSyntaxException, argument null pa NullPointerException; v nobenem primeru metoda ne vrne false. Če isti vzorec pogosto uporabljaš, ga enkrat prevedi z Pattern.compile(regex) in za vsak niz pokliči pattern.matcher(text).matches().

Primeri

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

Rezultat

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` se ujema v celoti, v `XAB.42` pa `find()` najde ujemajoči se podniz. Vezaj ne more nadomestiti dobesedne pike. Arabsko-indijske števke se ujemajo le z `(?U)`, pika pa zajame prelom vrstice le z `(?s)`.

Povezane lekcije

  • Java · Lekcija 1 · Srednja · Različica: 2

Viri