31 Regular expressions library [re]

31.10 Class template match_­results [re.results]

31.10.5 match_­results formatting [re.results.form]

template <class OutputIter> OutputIter format( OutputIter out, const char_type* fmt_first, const char_type* fmt_last, regex_constants::match_flag_type flags = regex_constants::format_default) const;

Requires: ready() == true и OutputIter должен удовлетворять требованиям для Output Iterator.

Effects: Копирует последовательность символов [fmt_­first, fmt_­last) в OutputIter out. Заменяет каждый спецификатор формата или escape-последовательность в скопированном диапазоне либо символом (ами), который он представляет, либо последовательностью символов, *this к которой он относится. Битовые маски, указанные в, flags определяют, какие спецификаторы формата и управляющие последовательности распознаются.

Returns: out.

template <class OutputIter, class ST, class SA> OutputIter format( OutputIter out, const basic_string<char_type, ST, SA>& fmt, regex_constants::match_flag_type flags = regex_constants::format_default) const;

Effects: Эквивалентен:

return format(out, fmt.data(), fmt.data() + fmt.size(), flags);

template <class ST, class SA> basic_string<char_type, ST, SA> format( const basic_string<char_type, ST, SA>& fmt, regex_constants::match_flag_type flags = regex_constants::format_default) const;

Requires: ready() == true.

Effects: Создает пустую строку result типа basic_­string<char_­type, ST, SA> и вызывает:

format(back_inserter(result), fmt, flags);

Returns: result.

string_type format( const char_type* fmt, regex_constants::match_flag_type flags = regex_constants::format_default) const;

Requires: ready() == true.

Effects: Создает пустую строку result типа string_­type и вызывает:

format(back_inserter(result), fmt, fmt + char_traits<char_type>::length(fmt), flags);

Returns: result.