CKTIS / C++
std::basic_string::assign — замяна на съдържанието на низ
Избери претоварването според източника. При буфер с известна дължина подай указател и брой елементи, за да запазиш нулевите знаци вътре в данните.
Версия: ISO C++23; implementation support may vary
Синтаксис
// ISO C++23 member declarations inside std::basic_string<CharT, Traits, Allocator> (<string>)
constexpr basic_string& assign(const basic_string& str);
constexpr basic_string& assign(basic_string&& str)
noexcept(std::allocator_traits<Allocator>::propagate_on_container_move_assignment::value ||
std::allocator_traits<Allocator>::is_always_equal::value);
constexpr basic_string& assign(const basic_string& str, size_type pos, size_type count = npos);
// Both templates require implicit conversion from const T& to std::basic_string_view<CharT, Traits>.
// Only the whole-source template also requires that const T& not be implicitly convertible to const CharT*.
template<class T> constexpr basic_string& assign(const T& t);
template<class T> constexpr basic_string& assign(const T& t, size_type pos, size_type count = npos);
constexpr basic_string& assign(const CharT* p, size_type count);
constexpr basic_string& assign(const CharT* p);
constexpr basic_string& assign(size_type count, CharT ch);
// InputIt must qualify as an input iterator.
template<class InputIt> constexpr basic_string& assign(InputIt first, InputIt last);
constexpr basic_string& assign(std::initializer_list<CharT> ilist);std::basic_string::assign, деклариран в <string>, заменя цялото съдържание на съществуващ низ, например std::string. Връща *this по референция, така че извикванията могат да се свързват. За разлика от append, не добавя в края. Претоварванията за цял basic_string действат като копиращия или преместващия operator=. Преместването не гарантира поемане на буфера на източника, а условието noexcept зависи от свойствата на алокатора.
assign(p, count) копира точно count елемента от тип CharT, включително вътрешните знаци \0. [p, p + count) трябва да е валиден диапазон, достъпен за четене; функцията не проверява размера на буфера. Преди извикването провери непроверената дължина спрямо наличните данни. За разлика от него assign(p) изисква валиден низ, завършващ с нулев знак, и копира само до първия нулев знак, без да го включва.
assign(src, pos, count) взема част от низ или от източник, преобразуем до изглед. Броят е ограничен до оставащата дължина; пропускането на count или подаването на npos означава копиране до края. pos == size() дава празен резултат, а pos > size() на източника води до std::out_of_range. И двата шаблона за изгледи (от C++17) изискват неявно преобразуване от const T& към съответния std::basic_string_view. Само шаблонът за целия източник изключва неявното преобразуване от const T& към const CharT*; за шаблона с pos и count това ограничение не важи.
assign(count, ch) записва count копия на ch, assign(first, last) копира валиден полуотворен диапазон от входни итератори, а assign({…}) копира инициализиращ списък. assign_range(r) е отделен метод от C++23; наличността му зависи от реализацията на стандартната библиотека.
Копието не запазва изглед към източника, но данните на източника трябва да са валидни по време на четенето. След успешно присвояване получи наново указателите, референциите, итераторите и изгледите към предишното съдържание на целевия низ: те може вече да са невалидни. Ако резултатът би надхвърлил max_size(), се хвърля std::length_error. Ако методът хвърли изключение, целевият низ остава непроменен; невалидният диапазон води до неопределено поведение, а не до гарантирано изключение.
Примери
#include <iostream>
#include <string>
#include <string_view>
int main() {
const char buffer[] = {'I', 'D', ':', 'A', '\0', 'B'};
const std::string_view record{buffer, sizeof buffer};
const auto separator = record.find(':');
if (separator == std::string_view::npos) {
std::cerr << "missing separator\n";
return 1;
}
const auto start = separator + 1;
std::string field = "old";
field.assign(record.data() + start, record.size() - start);
std::cout << "size=" << field.size() << '\n';
std::cout << "preserved="
<< (field == std::string("A\0B", 3) ? "yes" : "no") << '\n';
}Резултат
size=3 preserved=yes
Кодът сравнява резултата от `find` с `npos`, преди да изчисли позицията след задължителния разделител `:`. Буферът няма краен нулев знак; изрично зададената дължина позволява да се копират и трите елемента на полето: `A`, `\0` и `B`.
Свързани уроци
- C++ · Урок 58 · Напреднало · Версия: 3