База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Matcher.group() и Matcher.group(int): цялото съвпадение и групите

След успешно съвпадение прочети целия съвпаднал текст или само текста, уловен от избрана група. Група 0 означава цялото съвпадение.

Версия: Java SE 21

Синтаксис

public String group()
public String group(int group)

В Java SE 21 класът java.util.regex.Matcher предлага три претоварени версии на метода group, които връщат String. Тук са разгледани group() и group(int); третата версия, group(String), връща текста, уловен от именувана група. Matcher.group() връща целия съвпаднал откъс от входа и е равностоен на group(0). Matcher.group(int) с индекс от 1 до groupCount() връща текста, уловен от избраната група. Улавящите групи се номерират по отварящите им скоби отляво надясно. Неулавящата група (?:...) няма номер, а groupCount() не брои група 0.

Прочети групите, след като matches(), find() или lookingAt() върне true. matches() проверява целия текущ диапазон от входа, find() търси следващия съвпадащ откъс, а lookingAt() проверява дали съвпадението започва в началото на диапазона, без да изисква да го обхване изцяло. Методите group не търсят съвпадение. Прочети нужните стойности преди следващия опит или извикване на reset().

Ако има съвпадение, но избраната група не е участвала в него, group(int) връща null. Ако групата е участвала и е уловила нула знака, методът връща празния низ "". Преди първия опит, след неуспешен опит или след reset() без нов опит и двете версии хвърлят IllegalStateException. При валидно състояние на съвпадение индекс извън допустимия диапазон предизвиква IndexOutOfBoundsException. Смяната на шаблона с usePattern(...) след успешно съвпадение изчиства данните за групите; преди следващия опит и двете версии могат да върнат null.

Примери

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

public class Main {
    public static void main(String[] args) {
        Pattern pattern = Pattern.compile("(ID)-([0-9]+)([A-Z])?([ ]*)");
        Matcher matcher = pattern.matcher("item: ID-42");

        if (matcher.find()) {
            System.out.println("group() = [" + matcher.group() + "]");
            System.out.println("group(0) = [" + matcher.group(0) + "]");
            System.out.println("group(1) = [" + matcher.group(1) + "]");
            System.out.println("group(2) = [" + matcher.group(2) + "]");
            System.out.println("group(3) = " + matcher.group(3));
            System.out.println("group(4) = [" + matcher.group(4) + "]");
        }
    }
}

Резултат

group() = [ID-42]
group(0) = [ID-42]
group(1) = [ID]
group(2) = [42]
group(3) = null
group(4) = []

`find()` намира `ID-42` в `item: ID-42`. Група 3 не участва, защото незадължителната буква липсва. Група 4 съвпада с нула интервала, затова `[]` показва празен низ.

Свързани уроци

  • Java · Урок 70 · Начално · Версия: 2

Източници