Link Search Menu Expand Document

Совпадение

Стд::РегулярныеВыражения::Совпадение
Базовые типы: Объект

Иерархия типа

graph BT;
Совпадение-->Объект;

Представляет собой описание подстроки-совпадения, полученной в результате применения некоторого образца к некоторой строке.

Сравнение ссылочное


Примеры

Пусть есть строка:

знч ТестоваяСтрока = "1-один; 2-два; 3-три; 4-четыре; 5-пять"

Из строки нужно получить все сочетания вида “<цифра>-<название>". Для этого воспользуемся регулярным выражением с группами захвата:

// Создаем образец, позволяющий находить сочетания
знч ОбразецДляПоискаСочетаний = '(?<Цифра>\ц)-(?<Название>\с+)'

// Находим все сочетания в строке
знч РезультатПоиска = ОбразецДляПоискаСочетаний.НайтиСовпадения(ТестоваяСтрока)

// В РезультатПоиска содержатся все совпадения - можем их перебрать и получить новую строку вида "один:1 два:2 три:3 четыре:4 пять:5 "
пер НоваяСтрока = ""
для ОчереднойРезультат из РезультатПоиска
    НоваяСтрока += ОчереднойРезультат.Группа("Название") + ":" + ОчереднойРезультат.Группа("Цифра") + " "
;
// В итоге НоваяСтрока будет равна "один:1 два:2 три:3 четыре:4 пять:5 "

Методы

Группа

Группа(ИмяГруппы: Строка): Строка?
Перегрузка:
Группа(НомерГруппы: Число): Строка?

Возвращает самую правую подстроку, захваченную группой с именем ИмяГруппы. В случае, если данной группой не захвачена никакая подстрока - возвращается Undefined.

Исключения

ИсключениеНедопустимыйАргумент - в случае отсутствия группы с именем ИмяГруппы.


Группа

Группа(НомерГруппы: Число): Строка?
Перегрузка:
Группа(ИмяГруппы: Строка): Строка?

Возвращает самую правую подстроку, захваченную группой с номером НомерГруппы. В случае, если данной группой не захвачена никакая подстрока - возвращается Undefined.

Исключения

ИсключениеНедопустимыйАргумент - в случае отсутствия группы с номером НомерГруппы.


Длина

Длина(): Число

Длина подстроки-совпадения.


Значение

Значение(): Строка

Текстовое значение подстроки-соответствия.


Индекс

Индекс(): Число

Индекс начала подстроки-совпадения.


Список унаследованных методов

Объект