Совпадение

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

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

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

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

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

---

Примеры

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

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

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

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

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

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

---

Методы

Группа

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

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

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

Исключения

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

---

Группа

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

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

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

Исключения

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

---

Длина

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

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

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

---

Длина

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

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

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

Исключения

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

---

Длина

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

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

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

Исключения

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

---

Значение

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

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

---

Индекс

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

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

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

---

Индекс

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

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

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

Исключения

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

---

Индекс

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

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

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

Исключения

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

---

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

Объект

ВСтроку, ПолучитьТип, Представление