Biblioteka wyrażeń regularnych

 

C++

Język

Nagłówki biblioteki standardowej

Koncepty

Biblioteka narzędzi

Biblioteka string

Biblioteka kontenerów

Biblioteka algorytmów

Biblioteka iteratorów

Biblioteka numeryczna

Biblioteka wejścia/wyjścia

Biblioteka lokalizacji

Biblioteka wyrażeń regularnych (C++11)

Biblioteka operacji atomowych (C++11)

Biblioteka obsługi wątków (C++11)

 

Biblioteka wyrażeń regularnych

Klasy

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Algorytmy

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Iteratory

regex_iterator (C++11)

regex_token_iterator (C++11)

Wyjątki

regex_error (C++11)

Cechy

regex_traits (C++11)

Stałe

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

Gramatyka Regex

Modified ECMAScript-262 (C++11)

 

Zdefiniowane w nagłówku <regex>

Biblioteka wyrażeń regularnych dostarcza klasę, która reprezentuje wyrażenia regularne, które są rodzajem mini-języka używanego to wyszukiwania wzorca w tekście. Prawie wszystkie operacje wykorzystujące wyrażenia regularne mogą być scharakteryzowane jako operujące na kilku z następujących obiektów:

• Ciąg docelowy. Ciąg znaków, który jest przeszukiwany pod kątem wzorca. Może być określony jako ograniczony przez dwa iteratory, jako zakończony znakiem null lub jako obiekt klasy std::string.

• Wzorzec. Samo wyrażenie regularne, które określa, co spełnia dopasowanie. Jest obiektem klasy std::basic_regex, konstruowanym ze stringa ze specjalną składnią. W syntax_option_type znajduje się opis wspieranych składni.

• Tablica dopasowań. Informacje na temat dopasowań mogą być uzyskane jako obiekt klasy std::match_results.

• String zastępujący. String, który określa, jak zastępować dopasowania. W match_flag_type znajduje się opis wspieranych składni

Klasy główne

Te klasy enkapsulują wyrażenia regularne i rezultaty dopasowań wyrażenia regularnego w docelowym ciągu znaków.

Szablon:cpp/regex/dsc sub matchSzablon:cpp/regex/dsc match results

basic_regex (C++11)

obiekt wyrażenia regularnego (szablon klasy)

Algorytmy

Te funkcje są używane, by zastosować zenkapsulowane wyrażenie regularne do docelowego ciągu znaków.

Szablon:cpp/regex/dsc regex matchSzablon:cpp/regex/dsc regex searchSzablon:cpp/regex/dsc regex replace

Iteratory

Iteratory wyrażeń regularnych są używane w celu przeniesienia całego zbioru dopasowań wyrażenia regularnego znalezionych w ciągu.

Szablon:cpp/regex/dsc regex iteratorSzablon:cpp/regex/dsc regex token iterator

Wyjątki

Ta klasa definiuje typy obiektów rzucanych jako wyjątki by zgłaszać błędy z biblioteki wrażeń regularnych.

Szablon:cpp/regex/dsc regex error

Traits

Klasa cech wyrażeń regularnych jest używana w celu enkapsulacji cech branych pod uwagę przy dopasowaniu.

Szablon:cpp/regex/dsc regex traits

Stałe

Szablon:cpp/regex/dsc syntax option typeSzablon:cpp/regex/dsc match flag typeSzablon:cpp/regex/dsc error type

Defined in namespace std::regex_constants

Przykład

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

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("(\\S+)");
    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';
}

Wynik:

Text contains the phrase 'regular expressions'
Found 19 words
Words longer than 6 characters:
  people,
  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].