Share via


<regex>

Definiert eine Klassenvorlage zum Analysieren regulärer Ausdrücke (C++) und mehrerer Klassenvorlagen und Funktionen zum Durchsuchen von Text nach Übereinstimmungen mit einem regulären Ausdrucksobjekt.

Syntax

#include <regex>

Hinweise

Verwenden Sie zum Erstellen eines regulären Ausdrucksobjekts die Klassenvorlage basic_regex "Klasse" oder eine der Spezialisierungen regex und wregexzusammen mit den Syntaxkennzeichnungen des Typs regex_constants::syntax_option_type.

Um Text nach Übereinstimmungen mit einem regulären Ausdrucksobjekt zu suchen, verwenden Sie die Vorlagenfunktionen regex_match und regex_searchzusammen mit den Übereinstimmungskennzeichnungen vom Typ regex_constants::match_flag_type. Diese Funktionen geben Ergebnisse mithilfe der Klassenvorlage Klasse und deren Spezialisierungen, cmatch, , smatchwcmatch, und , zusammen wsmatchmit der Klassenvorlage sub_match Klasse und seinen Spezialisierungen, csub_match, , ssub_matchwcsub_matchund .wssub_matchmatch_results

Um Text zu ersetzen, der einem regulären Ausdrucksobjekt entspricht, verwenden Sie die Vorlagenfunktion regex_replacezusammen mit den Übereinstimmungskennzeichnungen des Typs regex_constants::match_flag_type.

Um mehrere Übereinstimmungen eines regulären Ausdrucksobjekts zu durchlaufen, verwenden Sie die Klassenvorlagen regex_iterator Klasse und regex_token_iterator Klasse oder eine ihrer Spezialisierungen, cregex_iterator, , sregex_iterator, wcregex_iterator, cregex_token_iteratorwsregex_iterator, sregex_token_iterator, wcregex_token_iteratoroder wsregex_token_iterator, zusammen mit den Übereinstimmungskennzeichnungen des Typs .regex_constants::match_flag_type

Um die Details der Grammatik regulärer Ausdrücke zu ändern, schreiben Sie eine Klasse, in der die Merkmale des regulären Ausdrucks implementiert sind.

Klassen

Klasse Beschreibung
basic_regex Umschließt einen regulären Ausdruck.
match_results Enthält eine Sequenz von Teilübereinstimmungen.
regex_constants Enthält zusammengestellte Konstanten.
regex_error Meldet einen ungültigen regulären Ausdruck.
regex_iterator Durchläuft Übereinstimmungsergebnisse.
regex_traits Beschreibt die Merkmale von Elementen zum Abgleichen.
regex_traits<char> Beschreibt die Merkmale von char zum Abgleichen.
regex_traits<wchar_t> Beschreibt die Merkmale von wchar_t zum Abgleichen.
regex_token_iterator Durchläuft Teilübereinstimmungen.
sub_match Beschreibt eine Teilübereinstimmung.

Typdefinitionen

Name Beschreibung
cmatch Typdefinition für charmatch_results.
cregex_iterator Typdefinition für charregex_iterator.
cregex_token_iterator Typdefinition für charregex_token_iterator.
csub_match Typdefinition für charsub_match.
regex Typdefinition für charbasic_regex.
smatch Typdefinition für stringmatch_results.
sregex_iterator Typdefinition für stringregex_iterator.
sregex_token_iterator Typdefinition für stringregex_token_iterator.
ssub_match Typdefinition für stringsub_match.
wcmatch Typdefinition für wchar_tmatch_results.
wcregex_iterator Typdefinition für wchar_tregex_iterator.
wcregex_token_iterator Typdefinition für wchar_tregex_token_iterator.
wcsub_match Typdefinition für wchar_tsub_match.
wregex Typdefinition für wchar_tbasic_regex.
wsmatch Typdefinition für wstringmatch_results.
wsregex_iterator Typdefinition für wstringregex_iterator.
wsregex_token_iterator Typdefinition für wstringregex_token_iterator.
wssub_match Typdefinition für wstringsub_match.

Funktionen

Function Beschreibung
regex_match Gleicht einen regulären Ausdruck exakt ab.
regex_replace Ersetzt übereinstimmende reguläre Ausdrücke.
regex_search Sucht nach einer Übereinstimmung mit einem regulären Ausdruck.
swap Tauscht basic_regex- oder match_results-Objekte.

Operatoren

Operator Beschreibung
operator== Vergleich von verschiedenen Objekten: gleich.
operator!= Vergleich von verschiedenen Objekten: ungleich.
operator< Vergleich von verschiedenen Objekten: kleiner als.
operator\<= Vergleich von verschiedenen Objekten: kleiner als oder gleich.
operator> Vergleich von verschiedenen Objekten: größer als.
operator>= Vergleich von verschiedenen Objekten: größer als oder gleich.
operator<< Fügt ein sub_match-Objekt in einem Stream ein.

Siehe auch

Reguläre Ausdrücke (C++)
regex_constants Klasse
regex_error Klasse
<regex>-Funktionen
regex_iterator Klasse
<regex> Operatoren
regex_token_iterator Klasse
regex_traits Klasse
<regex> TypeDefs