namespace std {
template <class OutputIterator, class BidirectionalIterator,
class traits, class charT, class FST, class FSA>
OutputIterator
regex_replace(OutputIterator out,
BidirectionalIterator first, BidirectionalIterator last,
const basic_regex<charT, traits>& e,
const basic_string<charT, FST, FSA>& fmt,
regex_constants::match_flag_type flags = regex_constants::match_default); // (1)
template <class OutputIterator, class BidirectionalIterator,
class traits, class charT>
OutputIterator
regex_replace(OutputIterator out,
BidirectionalIterator first, BidirectionalIterator last,
const basic_regex<charT, traits>& e,
const charT* fmt,
regex_constants::match_flag_type flags = regex_constants::match_default); // (2)
template <class traits, class charT, class ST, class SA, class FST, class FSA>
basic_string<charT, ST, SA>
regex_replace(const basic_string<charT, ST, SA>& s,
const basic_regex<charT, traits>& e,
const basic_string<charT, FST, FSA>& fmt,
regex_constants::match_flag_type flags = regex_constants::match_default); // (3)
template <class traits, class charT, class ST, class SA>
basic_string<charT, ST, SA>
regex_replace(const basic_string<charT, ST, SA>& s,
const basic_regex<charT, traits>& e,
const charT* fmt,
regex_constants::match_flag_type flags = regex_constants::match_default); // (4)
template <class traits, class charT, class FST, class FSA>
basic_string<charT>
regex_replace(const charT* s,
const basic_regex<charT, traits>& e,
const basic_string<charT, FST, FSA>& fmt,
regex_constants::match_flag_type flags = regex_constants::match_default); // (5)
template <class traits, class charT>
basic_string<charT>
regex_replace(const charT* s,
const basic_regex<charT, traits>& e,
const charT* fmt,
regex_constants::match_flag_type flags = regex_constants::match_default); // (6)
}
概要
指定された文字列の中で、正規表現にマッチする部分を指定した文字列に置換する。
置換は、全てのマッチする部分、あるいは、最初のマッチする部分のみのいずれかを指定可能である。
また、マッチしない部分を残すか否かも指定可能である。
効果
- (1), (2)
[first, last)で指定された文字列内に出現する、正規表現eにマッチする部分を、置換文字列fmtで置換した結果を出力イテレータoutに出力する。
置換文字列fmtには通常の文字の他、マッチした文字列全体やキャプチャグループを表すシーケンスを使用することができる。
指定可能なシーケンスは、デフォルトでは ECMAScript の置換文字列と等価であるが、flagsにregex_constants::format_sedが指定されていた場合には POSIX にて規定されている sed の置換文字列と等価となる。
なお、デフォルトでは全てのマッチする部分がfmtで置換されるが、flagsにregex_constants::format_first_onlyが指定されていた場合には最初にマッチする部分のみが置換される。
また、デフォルトではマッチしない部分はそのままoutに出力されるが、flagsにregex_constants::format_no_copyが指定されていた場合には、マッチしない部分はoutには出力されない。 - (3), (4) 置換対象文字列が
basic_string<charT, ST, SA>型の文字列sであること、および、置換結果がbasic_string<charT, ST, SA>型の文字列として返される点を除いて、(1), (2) と同様である。 - (5), (6) 置換対象文字列が
const charT*型の文字列sであること、および、置換結果がbasic_string<charT>型の文字列として返される点を除いて、(1), (2) と同様である。
戻り値
- (1), (2) 置換結果出力後の
out（引数のコピーではない） - (3), (4) 置換結果の文字列
- (5), (6) 置換結果の文字列
例外
本関数は regex_error を送出する可能性がある。
もしそのような例外 e が送出された場合、 e.code() は regex_constants::error_complexity か regex_constants::error_stack のいずれかである。
備考
本関数の正確な挙動は以下の通りである。
-
(1), (2)
regex_iterator型のオブジェクトiをregex_iterator<BidirectionalIterator, charT, traits> i(first, last, e, flags)として構築する。
-
iがシーケンス終端イテレータの場合（すなわち、マッチが 1 つも存在しない場合）
flags & regex_constants::format_no_copyが0であれば、out = copy(first, last, out)を呼び出す。
-
iがシーケンス終端イテレータでは無い場合（すなわち、マッチが 1 つ以上存在した場合）
iを用いて[first, last)で指定された文字列中のすべてのマッチをmatch_results<BidirectionalIterator>型のオブジェクトmとして列挙して以下を繰り返す。
ただし、flags & regex_constants::format_first_onlyが0でなければ、最初のマッチのみを処理する。-
flags & regex_constants::format_no_copyが0であれば、
を呼び出す。
-
その後、(1) の形式であれば
out = m.format(out, fmt, flags)を、(2) の形式であれば
out = m.format(out, fmt, fmt + char_traits<charT>::length(fmt), flags)を呼び出す。
最後に、
flags & regex_constants::format_no_copyが0であれば、最後のマッチのmのコピーをlast_mとしてを呼び出す。
-
-
-
(3), (4)
basic_string<charT, ST, SA>型の空の文字列オブジェクトresultを構築し、regex_replace(back_inserter(result), s.begin(), s.end(), e, fmt, flags)を呼び出す。
戻り値はresultとなる。 - (5), (6)
basic_string<charT>型の空の文字列オブジェクトresultを構築し、regex_replace(back_inserter(result), s, s + char_traits::length(s), e, fmt, flags)を呼び出す。
戻り値はresultとなる。
例
#include <iostream>
#include <iterator>
#include <list>
#include <regex>
#include <string>
int main()
{
{
// (1) の形式
const std::list<char> s = { 'a', 'b', 'c', '0', '1', '2', 'd', 'e', 'f' };
const std::regex re("\\d+");
const std::string fmt = "[$&]";
std::cout << "(1) '";
std::regex_replace(std::ostream_iterator<char>(std::cout), std::begin(s), std::end(s), re, fmt);
std::cout << '\'' << std::endl;
}
{
// (2) の形式
const std::list<char> s = { 'a', 'b', 'c', '0', '1', '2', 'd', 'e', 'f' };
const std::regex re("\\d+");
const char fmt[] = "[$&]";
const std::regex_constants::match_flag_type flags = std::regex_constants::format_no_copy;
std::cout << "(2) '";
std::regex_replace(std::ostream_iterator<char>(std::cout), std::begin(s), std::end(s), re, fmt, flags);
std::cout << '\'' << std::endl;
}
{
// (3) の形式
const std::string s = "abc123def456ghi";
const std::regex re("\\d+");
const std::string fmt = "[$&]";
std::cout << "(3) '" << std::regex_replace(s, re, fmt) << '\'' << std::endl;
}
{
// (4) の形式
const std::string s = "abc123def456ghi";
const std::regex re("\\d+");
const char fmt[] = "[$&]";
const std::regex_constants::match_flag_type flags = std::regex_constants::format_first_only;
std::cout << "(4) '" << std::regex_replace(s, re, fmt, flags) << '\'' << std::endl;
}
{
// (5) の形式
const char s[] = "abc123def456ghi";
const std::regex re("(\\d)(\\d)(\\d)");
const std::string fmt = "[$3$2$1]";
std::cout << "(5) '" << std::regex_replace(s, re, fmt) << '\'' << std::endl;
}
{
// (6) の形式
const char s[] = "abc123def456ghi";
const std::regex re("(\\d)(\\d)(\\d)");
const char fmt[] = "[\\3\\2\\1]";
const std::regex_constants::match_flag_type flags = std::regex_constants::format_sed;
std::cout << "(6) '" << std::regex_replace(s, re, fmt, flags) << '\'' << std::endl;
}
}
出力
(1) 'abc[012]def'
(2) '[012]'
(3) 'abc[123]def[456]ghi'
(4) 'abc[123]def456ghi'
(5) 'abc[321]def[654]ghi'
(6) 'abc[321]def[654]ghi'
バージョン
言語
- C++11
処理系
- Clang: 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅, 3.4 ✅, 3.5 ✅, 3.6 ✅
- GCC: 4.9.0 ✅, 4.9.1 ✅, 4.9.2 ✅, 5.0.0 ✅
- ICC: ??
- Visual C++: ??