std::basic_string<CharT,Traits,Allocator>::assign - cppreference.com

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

文字列の内容を置き換えます。

1) 内容を文字 ch のコピー count 個で置き換えます。

2) 内容を str のコピーで置き換えます。 *this = str; と同等です。 特に、アロケータの伝播が行われる場合があります。 (C++11以上)

3) 内容を str の部分文字列 [pos, pos+count) で置き換えます。 要求された部分文字列が文字列の終端を超える場合、または count == npos の場合、結果の部分文字列は [pos, str.size()) になります。 pos > str.size() の場合は std::out_of_range が投げられます。

4) ムーブセマンティクスを用いて、内容を str の内容で置き換えます。 *this = std::move(str) と同等です。 特に、アロケータの伝播が行われる場合があります。

5) 内容を範囲 [s, s+count) の文字のコピーで置き換えます。 この範囲はヌル文字を含むことができます。

6) 内容を s の指すヌル終端文字列の内容で置き換えます。 文字列の長さは Traits::length(s) を用いて最初のヌル文字によって決定されます。

7) 内容を範囲 [first, last) の文字のコピーで置き換えます。 このオーバーロードは、 InputIt が LegacyInputIterator を満たさない場合、オーバーロード解決に参加しません。 (C++11以上)

8) 内容を初期化子リスト ilist の内容で置き換えます。

9) std::basic_string_view<CharT, Traits> sv = t; によって行われたかのように、 t を文字列ビュー sv に暗黙に変換し、 assign(sv.data(), sv.size()) によって行われたかのように、内容を sv の内容で置き換えます。 このオーバーロードは、std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> が true であり、 std::is_convertible_v<const T&, const CharT*> が false である場合にのみ、オーバーロード解決に参加します。

10) std::basic_string_view<CharT, Traits> sv = t; によって行われたかのように、 t を文字列ビュー sv に暗黙に変換し、 内容を sv のサブビュー [pos, pos+count) の文字で置き換えます。 要求されたサブビューが sv の終端を超える場合、または count == npos の場合、結果のサブビューは [pos, sv.size()) になります。 pos > sv.size() の場合は std::out_of_range を投げます。 このオーバーロードは、std::is_convertible_v<const T&, std::basic_string_view<CharT, Traits>> が true であり、 std::is_convertible_v<const T&, const CharT*> が false である場合にのみ、オーバーロード解決に参加します。

引数

戻り値

*this。

計算量

1) count に比例。

2) str のサイズに比例。

3) count に比例。

4) 一定。 alloc が与えられていて alloc != other.get_allocator() の場合は比例。

5) count に比例。

6) s のサイズに比例。

7) first と last の距離に比例。

8) ilist のサイズに比例。

例外

何らかの理由で例外が投げられた場合、この関数は効果を持ちません (強い例外保証)。 (C++11以上)

操作の結果 size() > max_size() となる場合は std::length_error を投げます。

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

例

#include <iostream>
#include <iterator>
#include <string>

int main()
{
  std::string s;
  // assign(size_type count, CharT ch)
  s.assign(4, '=');
  std::cout << s << '\n'; // "===="
  
  std::string const c("Exemplary");
  // assign(basic_string const& str)
  s.assign(c);
  std::cout << c << "==" << s <<'\n'; // "Exemplary == Exemplary"

  // assign(basic_string const& str, size_type pos, size_type count)
  s.assign(c, 0, c.length()-1);
  std::cout << s << '\n'; // "Exemplar";

  // assign(basic_string&& str)
  s.assign(std::string("C++ by ") + "example");
  std::cout << s << '\n'; // "C++ by example"

  // assign(charT const* s, size_type count)
  s.assign("C-style string", 7);
  std::cout << s << '\n'; // "C-style"

  // assign(charT const* s)
  s.assign("C-style\0string");
  std::cout << s << '\n'; // "C-style"

  char mutable_c_str[] = "C-style string";
  // assign(InputIt first, InputIt last)
  s.assign(std::begin(mutable_c_str), std::end(mutable_c_str)-1);
  std::cout << s << '\n'; // "C-style string"

  // assign(std::initializer_list<charT> ilist)
  s.assign({ 'C', '-', 's', 't', 'y', 'l', 'e' });
  std::cout << s << '\n'; // "C-style"
}

====
Exemplary==Exemplary
Exemplar
C++ by example
C-style
C-style
C-style string
C-style

関連項目