std::regex_replace
| Definiert in Header <regex> |
||
| template< class OutputIt, class BidirIt, class Traits, class CharT, class STraits, class SAlloc > |
(1) | (seit C++11) |
| template< class OutputIt, class BidirIt, class Traits, class CharT > OutputIt regex_replace( OutputIt out, BidirIt first, BidirIt last, |
(2) | (seit C++11) |
| template< class Traits, class CharT, class STraits, class SAlloc, class FTraits, class FAlloc > |
(3) | (seit C++11) |
| template< class Traits, class CharT, class STraits, class SAlloc > std::basic_string<CharT, STraits, SAlloc> |
(4) | (seit C++11) |
| template< class Traits, class CharT, class STraits, class SAlloc > std::basic_string<CharT> |
(5) | (seit C++11) |
| template< class Traits, class CharT > std::basic_string<CharT> |
(6) | (seit C++11) |
regex_replace verwendet den regulären Ausdruck re, um Ersetzungen in der Zielzeichenkette durchzuführen.
[first, last) nach out, wobei Sequenzen, die mit re übereinstimmen, durch Zeichen ersetzt werden, die von fmt formatiert werden. Äquivalent zuusing iter_type = std::regex_iterator<BidirIt, CharT, Traits>; iter_type seq_begin(first, last, re, flags), seq_end; using result_type = std::match_results<BidirIt>; result_type m; bool need_to_copy = (flags & std::regex_constants::format_no_copy) == 0; bool format_all = (flags & std::regex_constants::format_first_only) != 0; for (iter_type i = seq_begin; i != seq.end(); ++i) { m = *i; if (need_to_copy) out = std::copy(m.prefix().first, m.prefix().second, out); if (format_all || i == seq_begin) out = /* replace-expr */ } if (need_to_copy) out = m.ready() ? std::copy(m.suffix().first, m.suffix().second, out) : std::copy(first, last, out); return out;
regex_replace(std::back_inserter(result),
str.begin(), str.end(), re, fmt, flags);
return result;.
regex_replace(std::back_inserter(result),
s, s + std::char_traits<CharT>::length(s), re, fmt, flags);
return result;.
Inhalt |
[edit] Parameter
| first, last | - | der Zielzeichenkettenbereich |
| str | - | die Ziel-std::string |
| s | - | die nullterminierte C-Style-Zeichenkette |
| re | - | der reguläre Ausdruck |
| fmt | - | der reguläre Ausdruck für die Ersetzung, die genaue Syntax hängt vom Wert von flags ab |
| flags | - | Flags, die bestimmen, wie der Abgleich durchgeführt werden soll |
| out | - | Ausgabe-Iterator zum Speichern des Ergebnisses der Ersetzung |
[edit] Rückgabewert
Wie oben beschrieben.
[edit] Ausnahmen
std::regex_error kann ausgelöst werden, um eine Fehlerbedingung anzuzeigen.
[edit] Beispiel
#include <iostream> #include <iterator> #include <regex> #include <string> int main() { std::string text = "Quick brown fox"; std::regex vowel_re("a|e|i|o|u"); // write the results to an output iterator std::regex_replace(std::ostreambuf_iterator<char>(std::cout), text.begin(), text.end(), vowel_re, "*"); // construct a string holding the results std::cout << '\n' << std::regex_replace(text, vowel_re, "[$&]") << '\n'; }
Ausgabe
Q**ck br*wn f*x Q[u][i]ck br[o]wn f[o]x
[edit] Fehlerberichte
Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | angewendet auf | Verhalten wie veröffentlicht | Korrigiertes Verhalten |
|---|---|---|---|
| LWG 2213 | C++11 | out wurde durch die Ersetzungen nicht aktualisiert | out wird aktualisiert |
[edit] Siehe auch
| (C++11) |
versucht, einen regulären Ausdruck an einen beliebigen Teil einer Zeichensequenz anzupassen (Funktionsvorlage) |
| (C++11) |
Optionen speziell für die Übereinstimmung (Typalias) |
| ersetzt einen angegebenen Teil eines Strings (public member function of std::basic_string<CharT,Traits,Allocator>) |
