std::basic_string<CharT,Traits,Allocator>:: assign
|
basic_string
&
assign
(
const
basic_string
&
str
)
;
|
(1) | (constexpr начиная с C++20) |
|
basic_string
&
assign
(
basic_string
&&
str
)
noexcept
(
/* см. ниже */
)
;
|
(2) |
(начиная с C++11)
(constexpr начиная с C++20) |
|
basic_string
&
assign
(
size_type count, CharT ch
)
;
|
(3) | (constexpr начиная с C++20) |
|
basic_string
&
assign
(
const
CharT
*
s, size_type count
)
;
|
(4) | (constexpr начиная с C++20) |
|
basic_string
&
assign
(
const
CharT
*
s
)
;
|
(5) | (constexpr начиная с C++20) |
|
template
<
class
SV
>
basic_string & assign ( const SV & t ) ; |
(6) |
(начиная с C++17)
(constexpr начиная с C++20) |
|
template
<
class
SV
>
basic_string
&
assign
(
const
SV
&
t,
|
(7) |
(начиная с C++17)
(constexpr начиная с C++20) |
| (8) | ||
|
basic_string
&
assign
(
const
basic_string
&
str,
size_type pos, size_type count ) ; |
(до C++14) | |
|
basic_string
&
assign
(
const
basic_string
&
str,
size_type pos, size_type count = npos ) ; |
(начиная с C++14)
(constexpr начиная с C++20) |
|
|
template
<
class
InputIt
>
basic_string & assign ( InputIt first, InputIt last ) ; |
(9) | (constexpr начиная с C++20) |
|
basic_string
&
assign
(
std::
initializer_list
<
CharT
>
ilist
)
;
|
(10) |
(начиная с C++11)
(constexpr начиная с C++20) |
Заменяет содержимое строки.
[
s
,
s
+
count
)
.
- std:: is_convertible_v < const SV & , std:: basic_string_view < CharT, Traits >> имеет значение true .
- std:: is_convertible_v < const SV & , const CharT * > имеет значение false .
return assign ( sv. data ( ) , sv. size ( ) ) ; .
return assign ( sv. substr ( pos, count ) ) ; .
|
Эквивалентно
return
assign
(
std::
basic_string_view
<
CharT, Traits
>
( str ) . substr ( pos, count ) ) ; . |
(начиная с C++20) |
|
Эта перегрузка участвует в разрешении перегрузки только если
|
(начиная с C++11) |
Содержание |
Параметры
| str | - | строка, используемая в качестве источника для инициализации символов |
| count | - | размер результирующей строки |
| ch | - | значение для инициализации символов строки |
| s | - | указатель на строку символов, используемую в качестве источника для инициализации строки |
| t | - | объект (преобразуемый в std::basic_string_view ) для инициализации символов строки |
| pos | - | индекс первого символа для взятия |
| first, last | - | диапазон для копирования символов |
| ilist | - | std::initializer_list для инициализации символов строки |
Возвращаемое значение
* this
Исключения
propagate_on_container_move_assignment
::
value
||
Если операция приведёт к тому, что
size()
превысит
max_size()
, выбрасывается
std::length_error
.
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Пример
#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(const basic_string& str) s.assign(c); std::cout << c << " == " << s << '\n'; // "Exemplary == Exemplary" // assign(const basic_string& 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(const CharT* s, size_type count) s.assign("C-style string", 7); std::cout << s << '\n'; // "C-style" // assign(const CharT* 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
Отчёты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 847 | C++98 | не было гарантии безопасности исключений | добавлена строгая гарантия безопасности исключений |
| LWG 2063 | C++11 |
необязательное примечание утверждало, что перегрузка
(
2
)
может быть реализована через обмен |
исправлено для требования перемещающего присваивания |
| LWG 2250 | C++98 |
поведение перегрузки
(
8
)
было
неопределенным, если pos > str. size ( ) равно true |
всегда выбрасывает исключение в этом случае |
| LWG 2579 | C++98 |
перегрузка
(
1
)
и оператор копирующего присваивания
имели различные эффекты |
они имеют одинаковый эффект |
| LWG 2946 | C++17 | перегрузка ( 6 ) вызывала неоднозначность в некоторых случаях | устранена путем превращения в шаблон |
Смотрите также
|
(C++23)
|
присваивает диапазон символов строке
(public member function) |
создает объект
basic_string
(public member function) |
|
|
присваивает значения строке
(public member function) |