Библиотека регулярных выражений (начиная с C++11)

Библиотека регулярных выражений предоставляет класс, представляющий регулярные выражения — разновидность мини-языка, используемого для поиска соответствий шаблону в строках. Почти все операции с регулярными выражениями можно описать с помощью нескольких следующих объектов:

• Целевая последовательность. Последовательность символов, в которой выполняется поиск по шаблону. Это может быть диапазон, заданный двумя итераторами, строка символов с нулевым завершающим символом или std::string.
• Шаблон. Само регулярное выражение. Оно определяет, что считается совпадением. Это объект типа std::basic_regex, созданный из строки с использованием специальной грамматики.
• Массив совпадений. Сведения о совпадениях можно получить в виде объекта типа std::match_results.
• Строка замены. Строка, определяющая, как заменять совпадения.

Грамматики регулярных выражений

Для шаблонов и строк замены поддерживаются следующие грамматики регулярных выражений:

• Изменённая грамматика регулярных выражений ECMAScript. Это грамматика по умолчанию.
• Базовая грамматика регулярных выражений POSIX.
• Расширенная грамматика регулярных выражений POSIX.
• Грамматика регулярных выражений, используемая утилитой awk в POSIX.
• Грамматика регулярных выражений, используемая утилитой grep в POSIX. Она практически совпадает с базовой грамматикой регулярных выражений POSIX, но дополнительно использует символ новой строки '\n' в качестве разделителя альтернатив.
• Грамматика регулярных выражений, используемая утилитой grep с параметром -E в POSIX. Она практически совпадает с расширенной грамматикой регулярных выражений POSIX, но дополнительно использует символ новой строки '\n' в качестве разделителя альтернатив наряду с '|'.

Также доступны некоторые варианты грамматик (например, поиск без учёта регистра). Подробности см. на этой странице.

Основные классы

Эти классы инкапсулируют регулярное выражение и результаты поиска соответствий регулярному выражению в целевой последовательности символов.

Алгоритмы

Эти функции применяют регулярное выражение, инкапсулированное в regex, к целевой последовательности символов.

Итераторы

Итераторы регулярных выражений используются для обхода полного набора совпадений с регулярным выражением, найденных в последовательности.

Исключения

Этот класс определяет тип объектов, выбрасываемых как исключения для сообщения об ошибках библиотеки регулярных выражений.

Свойства

Класс свойств регулярных выражений используется для инкапсуляции локализуемых аспектов регулярного выражения.

Константы

Пример

#include <iostream>
#include <iterator>
#include <regex>
#include <string>

int main()
{
    std::string s = "Some people, when confronted with a problem, think "
        "\"I know, I'll use regular expressions.\" "
        "Now they have two problems.";
    
    std::regex self_regex("REGULAR EXPRESSIONS",
        std::regex_constants::ECMAScript | std::regex_constants::icase);
    if (std::regex_search(s, self_regex))
        std::cout << "Text contains the phrase 'regular expressions'\n";
    
    std::regex word_regex("(\\w+)");
    auto words_begin = 
        std::sregex_iterator(s.begin(), s.end(), word_regex);
    auto words_end = std::sregex_iterator();
    
    std::cout << "Found "
              << std::distance(words_begin, words_end)
              << " words\n";
    
    const int N = 6;
    std::cout << "Words longer than " << N << " characters:\n";
    for (std::sregex_iterator i = words_begin; i != words_end; ++i)
    {
        std::smatch match = *i;
        std::string match_str = match.str();
        if (match_str.size() > N)
            std::cout << "  " << match_str << '\n';
    }
    
    std::regex long_word_regex("(\\w{7,})");
    std::string new_s = std::regex_replace(s, long_word_regex, "[$&]");
    std::cout << new_s << '\n';
}

Text contains the phrase 'regular expressions'
Found 20 words
Words longer than 6 characters:
  confronted
  problem
  regular
  expressions
  problems
Some people, when [confronted] with a [problem], think 
"I know, I'll use [regular] [expressions]." Now they have two [problems].