std::match_results<BidirIt,Alloc>::format

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Bibliothek für reguläre Ausdrücke

Klassen

basic_regex (C++11)

sub_match (C++11)

match_results (C++11)

Algorithmen

regex_match (C++11)

regex_search (C++11)

regex_replace (C++11)

Iteratoren

regex_iterator (C++11)

regex_token_iterator (C++11)

Ausnahmen

regex_error (C++11)

Traits

regex_traits (C++11)

Konstanten

syntax_option_type (C++11)

match_flag_type (C++11)

error_type (C++11)

Reguläre Ausdrucksgrammatiken

Modifizierte ECMAScript-262 (C++11)

 

std::match_results

Memberfunktionen

match_results::match_results

match_results::~match_results

match_results::operator=

match_results::get_allocator

Zustand

match_results::ready

Elementzugriff

match_results::size

match_results::max_size

match_results::empty

match_results::length

match_results::position

match_results::str

match_results::operator[]

match_results::prefix

match_results::suffix

Iteratoren

match_results::beginmatch_results::cbegin

match_results::endmatch_results::cend

Format

match_results::format

Modifizierer

match_results::swap

Nicht-Member-Funktionen

operator==operator!= (bis C++20)

swap(std::match_results)

 

template< class OutputIt > OutputIt format( OutputIt out,                  const char_type* fmt_first, const char_type* fmt_last,                  std::regex_constants::match_flag_type flags =                      std::regex_constants::format_default ) const;	(1)	(seit C++11)
template< class OutputIt, class ST, class SA > OutputIt format( OutputIt out,                  const basic_string<char_type,ST,SA>& fmt,                  std::regex_constants::match_flag_type flags =                      std::regex_constants::format_default ) const;	(2)	(seit C++11)
template< class ST, class SA > std::basic_string<char_type,ST,SA>     format( const std::basic_string<char_type,ST,SA>& fmt,             std::regex_constants::match_flag_type flags =                 std::regex_constants::format_default ) const;	(3)	(seit C++11)
string_type format( const char_type* fmt_s,                     std::regex_constants::match_flag_type flags =                         std::regex_constants::format_default ) const;	(4)	(seit C++11)

format gibt eine Formatzeichenkette aus, wobei Formatbezeichner oder Escape-Sequenzen in dieser Zeichenkette durch Übereinstimmungsdaten aus *this ersetzt werden.

1) Die Formatzeichenfolge wird durch den Bereich [fmt_first, fmt_last) definiert. Die resultierende Zeichenfolge wird nach out kopiert.

2) Die Formatzeichenfolge wird durch die Zeichen in fmt definiert. Die resultierende Zeichenfolge wird nach out kopiert.

3,4) Die Formatzeichenfolge wird durch die Zeichen in fmt bzw. fmt_s definiert. Die resultierende Zeichenfolge wird in eine neu konstruierte std::basic_string kopiert, die zurückgegeben wird.

Die Bitmaske flags bestimmt, welche Formatbezeichner und Escape-Sequenzen erkannt werden.

Das Verhalten von format ist undefiniert, wenn ready() != true.

Parameter

fmt_begin, fmt_end	-	Zeiger auf einen Bereich von Zeichen, der die Formatzeichenfolge definiert
fmt	-	std::basic_string, die die Formatzeichenfolge definiert
fmt_s	-	Zeiger auf eine nullterminierte Zeichenkette, die die Formatzeichenfolge definiert
out	-	Iterator, zu dem die resultierende Zeichenfolge kopiert wird
flags	-	std::regex_constants::match_flag_type Bitmaske, die angibt, welche Formatbezeichner und Escape-Sequenzen erkannt werden
Typanforderungen
- OutputIt muss die Anforderungen an LegacyOutputIterator erfüllen.

Rückgabewert

1,2) out

3,4) Die neu konstruierte Zeichenkette, die die resultierende Zeichenfolge enthält.

Exceptions

Kann implementierungsdefinierte Ausnahmen auslösen.

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <regex>
#include <string>
 
int main()
{
    std::string s = "for a good time, call 867-5309";
    std::regex phone_regex("\\d{3}-\\d{4}");
    std::smatch phone_match;
 
    if (std::regex_search(s, phone_match, phone_regex))
    {
        std::string fmt_s = phone_match.format(
            "$`"   // $` means characters before the match
            "[$&]" // $& means the matched characters
            "$'"); // $' means characters following the match
        std::cout << fmt_s << '\n';
    }   
}

Ausgabe

for a good time, call [867-5309]

Siehe auch

regex_replace (C++11)	ersetzt Vorkommen eines regulären Ausdrucks durch formatierten Ersetzungstext (Funktionsvorlage)
match_flag_type (C++11)	Optionen speziell für die Übereinstimmung (Typalias)