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; // (1)
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; // (2)
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; // (3)
string_type
format(const char_type* fmt,
regex_constants::match_flag_type flags = regex_constants::format_default) const; // (4)
概要
*this
を書式文字列に従って出力する。
要件
ready() == true
であること。- テンプレート引数
OutputIter
は出力イテレータの要件を満たすこと。
効果
- (1) 書式文字列
[fmt_first, fmt_last)
を出力イテレータout
にコピーする。 コピーされる書式文字列内のエスケープシーケンスや書式指定子は、対応する文字や*this
内の対応する文字列に置換される。
書式文字列の形式は、ビットマスクflags
で指定する。 - (2)
return format(out, fmt.data(), fmt.data() + fmt.size(), flags)
と等価。 - (3)
basic_string<char_type, ST, SA>
型の空の文字列変数result
を構築し、format(back_inserter(result), fmt, flags)
を呼び出す。 - (4)
string_type
型の空の文字列変数result
を構築し、format(back_inserter(result), fmt, fmt + char_traits<char_type>::length(fmt), flags)
を呼び出す。
戻り値
- (1)
out
- (2)
out
- (3) 構築した文字列変数
result
- (4) 構築した文字列変数
result
備考
flags
に指定可能な(指定して意味のある) regex_constants::match_flag_type
のフラグは、以下のいずれかのみである。
format_default
format_sed
例
#include <iostream>
#include <regex>
int main()
{
const char s[] = " 000 abc 123 def 999 ";
const std::regex re("(\\w+) (\\d+) (\\w+)");
std::cmatch m;
if (std::regex_search(s, m, re)) {
std::cout << m.format("$1$3 [$2]") << std::endl;
} else {
std::cout << "not match" << std::endl;
}
}
出力
abcdef [123]
バージョン
言語
- C++11
処理系
- Clang: 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅, 3.4 ✅, 3.5 ✅, 3.6 ✅
- GCC: 4.9.0 ✅, 4.9.1 ✅, 5.0.0 ✅
- ICC: ??
- Visual C++: ??