RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://en.cppreference.com/w/cpp/language/../regex/basic_regex/../match_results/format.html below:

std::match_results<BidirIt,Alloc>::format - cppreference.com

(1) (since C++11) (2) (since C++11) (3) (since C++11) (4) (since C++11)

format outputs a format string, replacing any format specifiers or escape sequences in that string with match data from *this.

1) The format character sequence is defined by the range [fmt_first, fmt_last). The resulting character sequence is copied to out.

2) The format character sequence is defined by the characters in fmt. The resulting character sequence is copied to out.

3,4)

The format character sequence is defined by the characters in

fmt

and

fmt_s

respectively. The resulting character sequence is copied to a newly constructed

std::basic_string

, which is returned.

The flags bitmask determines which format specifiers and escape sequences are recognized.

The behavior of format is undefined if ready() != true.

[edit] Parameters fmt_begin, fmt_end - pointers to a range of characters defining the format character sequence fmt - std::basic_string defining the format character sequence fmt_s - pointer to a null-terminated character string defining the format character sequence out - iterator that the resulting character sequence is copied to flags - std::regex_constants::match_flag_type bitmask specifying which format specifiers and escape sequences are recognized Type requirements -OutputIt must meet the requirements of LegacyOutputIterator. [edit] Return value

1,2) out

3,4) The newly constructed string containing resulting character sequence.

[edit] Exceptions

May throw implementation-defined exceptions.

[edit] Example

#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';
    }   
}

Output:

for a good time, call [867-5309]

[edit] See also

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4