C++

参考

<string>

basic_string

public member function
<string>

std::basic_string::assign

string (1)
basic_string& assign (const basic_string& str);
substring (2)
basic_string& assign (const basic_string& str, size_type subpos, size_type sublen);
c-string (3)
basic_string& assign (const charT* s);
buffer (4)
basic_string& assign (const charT* s, size_type n);
fill (5)
basic_string& assign (size_type n, charT c);
range (6)
template <class InputIterator>   basic_string& assign (InputIterator first, InputIterator last);
string (1)
basic_string& assign (const basic_string& str);
substring (2)
basic_string& assign (const basic_string& str, size_type subpos, size_type sublen);
c-string (3)
basic_string& assign (const charT* s);
buffer (4)
basic_string& assign (const charT* s, size_type n);
fill (5)
basic_string& assign (size_type n, charT c);
range (6)
template <class InputIterator>   basic_string& assign (InputIterator first, InputIterator last);
initializer list(7)
basic_string& assign (initializer_list<charT> il);
move (8)
basic_string& assign (basic_string&& str) noexcept;
string (1)
basic_string& assign (const basic_string& str);
substring (2)
basic_string& assign (const basic_string& str, size_type subpos, size_type sublen = npos);
c-string (3)
basic_string& assign (const charT* s);
buffer (4)
basic_string& assign (const charT* s, size_type n);
fill (5)
basic_string& assign (size_type n, charT c);
range (6)
template <class InputIterator>   basic_string& assign (InputIterator first, InputIterator last);
initializer list(7)
basic_string& assign (initializer_list<charT> il);
move (8)
basic_string& assign (basic_string&& str) noexcept;
将内容赋值给字符串
将新值赋给字符串，替换其当前内容。

(1) 字符串
复制 *str*。
(2) 子字符串
复制str中从字符位置subpos开始，跨越sublen个字符的部分（或者直到str的末尾，如果str太短或sublen是basic_string::npos）。
(3) C风格字符串
复制 *s* 指向的空终止字符序列（C 字符串）。
长度通过调用以下函数确定：traits_type::length(s).
(4) 缓冲区
从 *s* 指向的字符数组中复制前 *n* 个字符。
(5) 填充
用n个连续的字符c的副本替换当前值。
(6) 范围
复制范围内的字符序列[first,last)，以相同的顺序。
(7) 初始化列表
按相同顺序复制 *il* 中的每个字符。
(8) 移动
获取 *str* 的内容。
str 处于未指定但有效的状态。

参数

str
另一个具有相同类型的basic_string对象（具有相同的类模板参数charT, 特性 (traits)和Alloc)，其值被复制或移动。
subpos
str 中作为子字符串复制到对象的第一个字符的位置。
如果它大于str的长度，则抛出out_of_range。
注意：str中的第一个字符用值表示0(不是1).
sublen
要复制的子字符串的长度（如果字符串较短，则会复制尽可能多的字符）。
basic_string::npos值表示直到str末尾的所有字符。
s
指向字符数组的指针（例如c-string）。
n
要复制的字符数。
c
字符值，重复 *n* 次。
first, last
指向范围内初始位置和最终位置的输入迭代器。 使用的范围是[first,last)，其中包括first和last之间的所有字符，包括first指向的字符，但不包括last指向的字符。
函数模板参数InputIterator应为指向可转换为charT.
如果已知InputIterator是一种整数类型，参数被强制转换为适当的类型，以便使用签名 (5) 代替。
il
il
这些对象是从初始化列表声明符自动构造的。

charT是 basic_string 的字符类型（即，它的第一个模板参数）。
成员类型size_type是一种无符号整型类型。

返回值

*this

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
// string::assign
#include <iostream>
#include <string>

int main ()
{
  std::string str;
  std::string base="The quick brown fox jumps over a lazy dog.";

  // used in the same order as described above:

  str.assign(base);
  std::cout << str << '\n';

  str.assign(base,10,9);
  std::cout << str << '\n';         // "brown fox"

  str.assign("pangrams are cool",7);
  std::cout << str << '\n';         // "pangram"

  str.assign("c-string");
  std::cout << str << '\n';         // "c-string"

  str.assign(10,'*');
  std::cout << str << '\n';         // "**********"

  str.assign<int>(10,0x2D);
  std::cout << str << '\n';         // "----------"

  str.assign(base.begin()+16,base.end()-12);
  std::cout << str << '\n';         // "fox jumps over"

  return 0;
}

输出
The quick brown fox jumps over a lazy dog.
brown fox
pangram
c-string
**********
----------
fox jumps over


复杂度

未指定。
未指定，但通常与新的字符串长度呈线性关系（对于移动版本而言是常数）。

迭代器有效性

与此对象相关的任何迭代器、指针和引用都可能失效。

数据竞争

对象被修改。
移动赋值形式(8)会修改str。

异常安全

对于移动赋值 (8)，该函数不会抛出异常（无抛出保证）。
在所有其他情况下，如果抛出异常，则不会产生任何影响（强保证）。

如果已知s没有指向足够长的数组，或者如果指定的范围是[first,last)无效，则会导致未定义行为。

如果subpos大于str的长度，则会抛出out_of_range异常。
如果结果 字符串长度 超过 max_size，则会抛出 length_error 异常。
如果该类型使用默认分配器，如果函数需要分配存储空间但失败，则会抛出bad_alloc异常。

另见

basic_string::operator=
字符串赋值 (公共成员函数)
basic_string::append
追加到字符串 (公共成员函数)
basic_string::insert
插入到字符串 (公共成员函数)
basic_string::replace
替换字符串的一部分 (public member function)