GeezerVison

The World Wide Web, restored to 800 pixels of glory.

GeezerVison is showing cpprefjp.github.io — std::basic_string::replace - cpprefjp C++日本語リファレンス

最終更新日時: 2026年10月03日 22時31分04秒 (JST)
Akira Takahashi が更新

function

std::basic_string::replace

basic_string&
  replace(size_type pos1,
          size_type n1,
          const basic_string& str); // (1) C++98
constexpr basic_string&
  replace(size_type pos1,
          size_type n1,
          const basic_string& str); // (1) C++20

basic_string&
  replace(size_type pos1,
          size_type n1,
          const basic_string& str,
          size_type pos2,
          size_type n2);           // (2) C++11
basic_string&
  replace(size_type pos1,
          size_type n1,
          const basic_string& str,
          size_type pos2,
          size_type n2 = npos);    // (2) C++14
constexpr basic_string&
  replace(size_type pos1,
          size_type n1,
          const basic_string& str,
          size_type pos2,
          size_type n2 = npos);    // (2) C++20

basic_string&
  replace(size_type pos,
          size_type n1,
          const charT* s,
          size_type n2);  // (3) C++98
constexpr basic_string&
  replace(size_type pos,
          size_type n1,
          const charT* s,
          size_type n2);  // (3) C++20

basic_string&
  replace(size_type pos,
          size_type n1,
          const charT* s); // (4) C++98
constexpr basic_string&
  replace(size_type pos,
          size_type n1,
          const charT* s); // (4) C++20

basic_string&
  replace(size_type pos,
          size_type n1,
          size_type n2,
          charT c);      // (5) C++98
constexpr basic_string&
  replace(size_type pos,
          size_type n1,
          size_type n2,
          charT c);      // (5) C++20

basic_string&
  replace(iterator i1,
          iterator i2,
          const basic_string& str); // (6) C++98
basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const basic_string& str); // (6) C++11
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const basic_string& str); // (6) C++20

basic_string&
  replace(iterator i1,
          iterator i2,
          const charT* s,
          size_type n);      // (7) C++98
basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const charT* s,
          size_type n);      // (7) C++11
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const charT* s,
          size_type n);      // (7) C++20

basic_string&
  replace(iterator i1,
          iterator i2,
          const charT* s);   // (8) C++98
basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const charT* s);   // (8) C++11
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const charT* s);   // (8) C++20

basic_string&
  replace(iterator i1,
          iterator i2,
          size_type n,
          charT c);              // (9) C++98
basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          size_type n, charT c); // (9) C++11
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          size_type n, charT c); // (9) C++20

template <class InputIterator>
basic_string&
  replace(iterator i1,
          iterator i2,
          InputIterator j1,
          InputIterator j2);     // (10) C++98
template <class InputIterator>
basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          InputIterator j1,
          InputIterator j2);     // (10) C++11
template <class InputIterator>
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          InputIterator j1,
          InputIterator j2);     // (10) C++20

basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          initializer_list<charT> il); // (11) C++11
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          initializer_list<charT> il); // (11) C++20

// string_viewを引数に取るオーバーロード
template<class T>
basic_string&
  replace(size_type pos1,
          size_type n1,
          const T& t);    // (12) C++17
template<class T>
constexpr basic_string&
  replace(size_type pos1,
          size_type n1,
          const T& t);    // (12) C++20

template<class T>
basic_string&
  replace(size_type pos1,
          size_type n1,
          const T& t,
          size_type pos2,
          size_type n2 = npos); // (13) C++17
template<class T>
constexpr basic_string&
  replace(size_type pos1,
          size_type n1,
          const T& t,
          size_type pos2,
          size_type n2 = npos); // (13) C++20

template<class T>
basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const T& t);       // (14) C++17
template<class T>
constexpr basic_string&
  replace(const_iterator i1,
          const_iterator i2,
          const T& t);       // (14) C++20

概要

文字列の一部を置換する。

テンプレートパラメータ制約

(12), (13), (14) : 以下の両方を満たしていること
- is_convertible_v<const T&, basic_string_view<charT, traits>> == true
- is_convertible_v<const T&, const charT*> == false

要件

(1) : pos1 <= size()
(2) : pos1 <= size()、およびpos2 <= str.size()であること。
(3) : pos1 <= size()、および文字配列へのポインタsが、少なくてもn2個の要素を持つ配列を指していること。
(4) : pos <= size()、および文字配列へのポインタsが、少なくてもtraits::length(s) + 1個の要素を指す配列を指していること。
(6) : [begin(), i1)および[i1, i2)が有効なイテレータ範囲であること。
(7) : [begin(), i1)および[i1, i2)が有効なイテレータ範囲であること。また、文字配列へのポインタsが、少なくてもn個の要素を持つ配列を指していること。
(8) : [begin(), i1)および[i1, i2)が有効なイテレータ範囲であること。および文字配列へのポインタsが、少なくてもtraits::length(s) + 1個の要素を指す配列を指していること。
(9) : [begin(), i1)および[i1, i2)が有効なイテレータ範囲であること。
(10) : [begin(), i1)、[i1, i2)、および[j1, j2)が有効なイテレータ範囲であること。
(11) : [begin(), i1)および[i1, i2)が有効なイテレータ範囲であること。
(14) : [begin(), i1)および[i1, i2)が有効なイテレータ範囲であること。

効果

(1) : replace(pos1, n1, str.data(), str.size())を呼び出す。
(2) :
- n2とstr.size() - pos2のうち小さい方をrlenとする。n2 == npos の場合は、 str.size() - pos2 が使用される。
- replace(pos1, n1, str.data() + pos2, rlen)を呼び出す。
(3) : n1とsize() - pos1のうち小さい方をxlenとし、自身のpos1番目からxlen個の要素を、文字配列sの先頭n2文字で置き換える。
(4) : replace(pos, n, s, traits::length(s))を呼び出す。
(5) : replace(pos1, n1, basic_string(n2, c))と同じ効果を持つ。
(6) : replace(i1 - begin(), i2 - i1, str)を呼び出す。
(7) : replace(i1 - begin(), i2 - i1, s, n)を呼び出す。
(8) : replace(i1 - begin(), i2 - i1, s, traits::length(s))を呼び出す。
(9) : replace(i1 - begin(), i2 - i1, basic_string(n, c))を呼び出す。
(10) : replace(i1 - begin(), i2 - i1, basic_string(j1, j2))を呼び出す。
(11) : replace(i1 - begin(), i2 - i1, il.begin(), il.size())を呼び出す。

(12) : 以下と等価。

basic_string_view<charT, traits> sv = t;
return replace(pos1, n1, sv.data(), sv.size());

(13) : 以下と等価。

basic_string_view<charT, traits> sv = t;
return replace(pos1, n1, sv.substr(pos2, n2));

(14) : 以下と等価。

basic_string_view<charT, traits> sv = t;
return replace(i1 - begin(), i2 - i1, sv.data(), sv.size());

戻り値

*this

例外

(1) : pos1 > size()の場合、out_of_range例外を送出する。
(2) : pos1 > size()もしくはpos2 > str.size()である場合、out_of_range例外を送出する。
(3) : pos1 > size()の場合、out_of_range例外を送出する。また、置き換え結果の文字列がmax_size()を超えた場合、length_error例外を送出する。
(13) : pos1 > size()もしくはpos2 > sv.size()である場合、out_of_range例外を送出する。

例

#include <iostream>
#include <string>
#include <string_view>

int main()
{
  // (1) 指定した位置からN文字を、文字列で置き換える
  {
    std::string s1 = "12345";
    std::string s2 = "abcde";

    // 1番目から2文字を、s2文字列で置き換える
    s1.replace(1, 2, s2);

    std::cout << "(1) : " << s1 << std::endl;
  }

  // (2) 指定した位置からN文字を、文字列の一部で置き換える
  {
    std::string s1 = "12345";
    std::string s2 = "abcde";

    // 1番目から2文字を、s2.substr(2, 3)で置き換える
    s1.replace(1, 2, s2, 2, 3);

    std::cout << "(2) : " << s1 << std::endl;
  }

  // (3) 指定した位置からN文字を、文字配列の先頭M文字で置き換える
  {
    std::string s1 = "12345";

    // 1番目から2文字を、"abcde"の先頭3文字で置き換える
    s1.replace(1, 2, "abcde", 3);

    std::cout << "(3) : " << s1 << std::endl;
  }

  // (4) 指定した位置からN文字を、文字配列で置き換える
  {
    std::string s = "12345";

    s.replace(1, 2, "abcde");

    std::cout << "(4) : " << s << std::endl;
  }

  // (5) 指定した位置からN文字を、M個の文字で置き換える
  {
    std::string s = "12345";

    // 1番目から2文字を、3個の'x'で置き換える
    s.replace(1, 2, 3, 'x');

    std::cout << "(5) : " << s << std::endl;
  }

  // (6) 指定したイテレータ範囲を、文字列で置き換える
  {
    std::string s1 = "12345";
    std::string s2 = "abcde";

    // '2'から'3'をs2で置き換える
    s1.replace(s1.begin() + 1, s1.begin() + 3, s2);

    std::cout << "(6) : " << s1 << std::endl;
  }

  // (7) 指定したイテレータ範囲を、文字配列の先頭N文字で置き換える
  {
    std::string s = "12345";

    // '2'から'3'を、"abcde"の先頭3文字で置き換える
    s.replace(s.begin() + 1, s.begin() + 3, "abcde", 3);

    std::cout << "(7) : " << s << std::endl;
  }

  // (8) 指定したイテレータ範囲を、文字配列で置き換える
  {
    std::string s = "12345";

    s.replace(s.begin() + 1, s.begin() + 3, "abcde");

    std::cout << "(8) : " << s << std::endl;
  }

  // (9) 指定したイテレータ範囲を、N個の文字で置き換える
  {
    std::string s = "12345";

    // '2'から'3'を、3個の'x'で置き換える
    s.replace(s.begin() + 1, s.begin() + 3, 3, 'x');

    std::cout << "(9) : " << s << std::endl;
  }

  // (10) 指定したイテレータ範囲を、他のイテレータ文字範囲で置き換える
  {
    std::string s1 = "12345";
    std::string s2 = "abcde";

    s1.replace(s1.begin() + 1, s1.begin() + 3, s2.begin(), s2.end());

    std::cout << "(10) : " << s1 << std::endl;
  }

  // (11) 指定したイテレータ範囲を、文字の初期化子リストで置き換える
  {
    std::string s = "12345";

    s.replace(s.begin() + 1, s.begin() + 3, {'a', 'b', 'c', 'd', 'e'});

    std::cout << "(11) : " << s << std::endl;
  }

  // (12) 指定した範囲を、basic_string_viewが参照する文字列範囲で置き換える
  {
    std::string s1 = "12345";
    std::string_view sv2 = std::string_view{"XXXabcdeYYY"}.substr(3, 5);

    // 1番目から2文字を、sv2文字列で置き換える
    s1.replace(1, 2, sv2);

    std::cout << "(12) : " << s1 << std::endl;
  }

  // (13) 指定した範囲を、basic_string_viewの指定された範囲で置き換える
  {
    std::string s1 = "12345";
    std::string_view sv2 = "XXXabcdeYYY";

    // 1番目から2文字を、sv2文字列で置き換える
    s1.replace(1, 2, sv2, 3, 5);

    std::cout << "(13) : " << s1 << std::endl;
  }

  // (14) 指定したイテレータ範囲を、basic_string_viewが参照する文字列範囲で置き換える
  {
    std::string s1 = "12345";
    std::string_view sv2 = std::string_view{"XXXabcdeYYY"}.substr(3, 5);

    // 1番目から2文字を、sv2文字列で置き換える
    s1.replace(s1.begin() + 1, s1.begin() + 3, sv2);

    std::cout << "(14) : " << s1 << std::endl;
  }
}

出力

(1) : 1abcde45
(2) : 1cde45
(3) : 1abc45
(4) : 1abcde45
(5) : 1xxx45
(6) : 1abcde45
(7) : 1abc45
(8) : 1abcde45
(9) : 1xxx45
(10) : 1abcde45
(11) : 1abcde45
(12) : 1abcde45
(13) : 1abcde45
(14) : 1abcde45

参照

N2679 Initializer Lists for Standard Containers(Revision 1)
- (11)の経緯となる提案文書
LWG ISsue 2268. Setting a default argument in the declaration of a member function assign of std::basic_string
- C++14から(2)のオーバーロードに、n = nposのデフォルト引数を追加。
P0254R2 Integrating std::string_view and std::string
LWG Issue 1323. basic_string::replace should use const_iterator
- C++11で、イテレータで範囲を指定するオーバーロードの引数型がiteratorからconst_iteratorへ改められた。ほかのコンテナと扱いを揃えるため
LWG Issue 2758. std::string{}.assign("ABCDE", 0, 1) is ambiguous
P0980R1 Making std::string constexpr
LWG Issue 2946. LWG 2758's resolution missed further corrections
- 意図しない暗黙変換防止のためにstring_viewを受けるオーバーロード(12), (13), (14)の引数型をconst T&に変更

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.