std::basic_string<CharT,Traits,Allocator>::assign — cppreference.com
Материал из 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) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (2) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (3) | ||
|
|
(до C++14) | |
|
|
(начиная с C++14) (до C++20) |
|
|
|
(начиная с C++20) | |
| (4) | ||
|
|
(начиная с C++11) (до C++20) |
|
|
|
(начиная с C++20) | |
| (5) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (6) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (7) | ||
|
|
(до C++20) | |
|
|
(начиная с C++20) | |
| (8) | ||
|
|
(начиная с C++11) (до C++20) |
|
|
|
(начиная с C++20) | |
| (9) | ||
|
|
(начиная с C++17) (до C++20) |
|
|
|
(начиная с C++20) | |
| (10) | ||
|
|
(начиная с C++17) (до C++20) |
|
|
|
(начиная с C++20) | |
Заменяет содержимое строки.
1) Заменяет содержимое count копиями символа ch.
2) Заменяет содержимое копией str. Эквивалентно *this = str;. В частности, может иметь место распространение аллокатора. (начиная с C++11)
3) Заменяет содержимое подстрокой [pos, pos + count) из str. Если запрошенная подстрока выходит за конец строки или если 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) Неявно преобразует t в строковое представление sv, как если бы с помощью std::basic_string_view<CharT, Traits> sv = t;, затем заменяет содержимое на содержимое sv, как будто с помощью assign(sv.data(), sv.size()).
Эта перегрузка участвует в разрешении перегрузки, только если std::is_convertible_v<const StringViewLike&,std::basic_string_view<CharT, Traits>> равно true и std::is_convertible_v<const StringViewLike&, const CharT*> равно false.
10) Неявно преобразует t в строковое представление sv, как если бы с помощью std::basic_string_view<CharT, Traits> sv = t;, затем заменяет содержимое символами из подпредставления [pos, pos + count) из sv. Если запрошенное подпредставление продолжается после конца sv или если count == npos, результирующее подпредставление будет [pos, sv.size()). Если pos > sv.size(), генерируется std::out_of_range.
Эта перегрузка участвует в разрешении перегрузки, только если std::is_convertible_v<const StringViewLike&,std::basic_string_view<CharT, Traits>> равно true и std::is_convertible_v<const StringViewLike&, const CharT*> равно false.
Параметры
| count | — | размер строки результата |
| pos | — | индекс первого символа, который нужно принять |
| ch | — | значение для инициализации символов строки |
| first, last | — | диапазон для копирования символов |
| str | — | строка, которая будет использоваться в качестве источника для инициализации символов |
| s | — | указатель на строку символов, которая будет использоваться в качестве источника для инициализации строки |
| ilist | — | std::initializer_list для инициализации символов строки |
| t | — | объект (конвертируемый в std::basic_string_view) для инициализации символов строки |
| Требования к типам | ||
-InputIt должен соответствовать требованиям LegacyInputIterator.
| ||
Возвращаемое значение
*this
Сложность
1) Линейная по count.
2) Линейная по размеру str.
3) Линейная по count.
4) Константная. Если задан alloc и alloc != other.get_allocator(), то линейная.
5) Линейная по count.
6) Линейная по размеру s.
7) Линейная по расстоянию между first и last.
8) Линейная по размеру ilist.
9) Линейная по размеру t.
Исключения
4)
спецификация
noexcept:
noexcept(std::allocator_traits<Allocator>:: propagate_on_container_move_assignment::value || std::allocator_traits<Allocator>::is_always_equal::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("Образец"); // assign(const basic_string& str) s.assign(c); std::cout << c << " == " << s << '\n'; // "Образец == Образец" // assign(const basic_string& str, size_type pos, size_type count) s.assign(c, 0, c.length() - 1); std::cout << s << '\n'; // "Образе"; // assign(basic_string&& str) s.assign(std::string("С++ на ") + "примере"); std::cout << s << '\n'; // "С++ на примере" // assign(const CharT* s, size_type count) s.assign("строка в стиле C", 7); std::cout << s << '\n'; // "строка " // assign(const CharT* s) s.assign("строка\0в стиле С"); std::cout << s << '\n'; // "строка" char mutable_c_str[] = "строка в стиле С"; // assign(InputIt first, InputIt last) s.assign(std::begin(mutable_c_str), std::end(mutable_c_str) - 1); std::cout << s << '\n'; // "строка в стиле С" // assign(std::initializer_list<CharT> ilist) s.assign({'C', '-', 's', 't', 'y', 'l', 'e'}); std::cout << s << '\n'; // "C-style" }
Вывод:
==== Образец == Образец Образе С++ на примере строка строка строка в стиле С C-style
Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| LWG 847 | C++98 | не было гарантии безопасности исключений | добавлена надёжная гарантия безопасности исключений |
| LWG 2063 | C++11 | в ненормативном примечании указано, что swap является допустимой реализацией присваивания перемещением |
исправлено требование присваивания перемещением |
| LWG 2579 | C++11 | assign(const basic_string&) не распространяла аллокаторы
|
сделано для распространения аллокаторов, если это необходимо |
| LWG 2946 | C++17 | перегрузка (9) в некоторых случаях вызывала двусмысленность | исключено, сделав его шаблоном |