Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

String.matches: porovnanie celého reťazca s regulárnym výrazom

Over, či celý reťazec zodpovedá regulárnemu výrazu. Zisti, ako `(?s)` mení správanie bodky, ktoré triedy znakov predvolene používajú ASCII a ako zapísať spätné lomky v literáloch Javy.

Verzia: Java SE 21

Syntax

public boolean matches(String regex)

String.matches je inštančná metóda triedy java.lang.String. Volanie text.matches(regex) spracuje argument ako regulárny výraz a vráti true, len ak mu zodpovedá celý text, nielen jeho časť. Kotvy ^ a $ na to nepotrebuješ. Na vyhľadanie zodpovedajúceho podreťazca použi Pattern.compile(regex).matcher(text).find().

Na začiatok vzoru vlož (?s), čím zapneš režim DOTALL: . potom zodpovedá aj znakom konca riadka, ktoré predvolene nezahŕňa. Nezamieňaj (?s) s (?m): režim MULTILINE mení správanie kotiev ^ a $, nie bodky.

V regulárnom výraze [A-Z] označuje rozsah veľkých písmen ASCII od A po Z. Predvolene je \d to isté ako [0-9] a \w to isté ako [a-zA-Z_0-9]. Príznak (?U) (UNICODE_CHARACTER_CLASS) zapne varianty týchto preddefinovaných tried podľa Unicode, ale explicitný rozsah [A-Z] nerozšíri.

Reťazcové literály Javy a regulárne výrazy sa spracúvajú oddelene. Zapíš "\\d", aby modul regulárnych výrazov dostal \d, a "\\.", aby dostal \. a rozpoznal doslovnú bodku. Neplatný vzor vyvolá PatternSyntaxException a argument null vyvolá NullPointerException; ani v jednom prípade metóda nevráti false. Ak rovnaký vzor používaš opakovane, skompiluj ho raz pomocou Pattern.compile(regex) a pre každý reťazec volaj pattern.matcher(text).matches().

Príklady

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

Výsledok

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` zodpovedá vzoru celé, zatiaľ čo v `XAB.42` metóda `find()` nájde zodpovedajúci podreťazec. Spojovník nenahrádza doslovnú bodku. Arabsko-indické číslice zodpovedajú vzoru len s `(?U)` a bodka zodpovedá koncu riadka len s `(?s)`.

Súvisiace lekcie

  • Java · Lekcia 1 · Stredne pokročilá · Verzia: 2

Zdroje