Skip to content

format.md

Latest commit

 

History

History
100 lines (78 loc) · 3.6 KB

format.md

File metadata and controls

100 lines (78 loc) · 3.6 KB

format

  • regex[meta header]
  • std[meta namespace]
  • match_results[meta class]
  • function template[meta id-type]
  • cpp11[meta cpp]
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)
  • basic_string[link ../../string/basic_string.md]
  • regex_constants::format_default[link ../regex_constants/match_flag_type.md]

概要

*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;
  }
}
  • format[color ff0000]
  • std::regex[link ../basic_regex.md]
  • std::cmatch[link ../match_results.md]
  • std::regex_search[link ../regex_search.md]

出力

abcdef [123]

バージョン

言語

  • C++11

処理系

  • Clang: 3.0 [mark verified], 3.1 [mark verified], 3.2 [mark verified], 3.3 [mark verified], 3.4 [mark verified], 3.5 [mark verified], 3.6 [mark verified]
  • GCC: 4.9.0 [mark verified], 4.9.1 [mark verified], 5.0.0 [mark verified]
  • ICC: ??
  • Visual C++: ??