Совпадение

Стд::РегулярныеВыражения::Совпадение

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

Сравнение

Ссылочное

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

Базовые типы: Объект

---

Примеры

Общие примеры

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

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

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

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

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

// В итоге НоваяСтрока будет содержать строку "один:1 два:2 три:3 четыре:4 пять:5 "

---

Методы

Группа

Группа(ИмяГруппы: Строка): Строка?

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

Исключения

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

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

---

Группа

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

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

Исключения

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

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

---

Длина

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

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

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

---

Длина

Длина(ИмяГруппы: Строка): Число

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

Исключения

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

Перегрузка
Длина(): Число
Длина(НомерГруппы: Число): Число

---

Длина

Длина(НомерГруппы: Число): Число

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

Исключения

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

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

---

Значение

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

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

---

Индекс

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

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

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

---

Индекс

Индекс(ИмяГруппы: Строка): Число

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

Исключения

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

Перегрузка
Индекс(): Число
Индекс(НомерГруппы: Число): Число

---

Индекс

Индекс(НомерГруппы: Число): Число

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

Исключения

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

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

---

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

Объект

ВСтроку

ПолучитьТип

Представление