CKTIS / C++
std::basic_string::assign — nahradenie obsahu reťazca
Vyberte preťaženie podľa zdroja. Pri buffri so známou dĺžkou odovzdajte ukazovateľ a počet prvkov, aby sa zachovali aj nulové znaky vnútri údajov.
Verzia: ISO C++23; implementation support may vary
Syntax
// 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 z hlavičky <string> nahrádza celý obsah existujúceho reťazca, napríklad std::string. Vracia *this referenciou, takže volania možno reťaziť. Na rozdiel od append nepridáva nič na koniec. Preťaženia pre celý basic_string fungujú ako kopírovací alebo presúvací operator=. Presun nemusí prevziať buffer zdroja a jeho podmienka noexcept závisí od vlastností alokátora.
assign(p, count) kopíruje presne count prvkov CharT vrátane vnútorných znakov \0. [p, p + count) musí byť platný a čitateľný rozsah; funkcia veľkosť buffra nekontroluje. Pred volaním overte nedôveryhodnú dĺžku podľa množstva dostupných údajov. assign(p) naopak vyžaduje platný reťazec ukončený nulovým znakom a kopíruje len po prvý nulový znak, bez neho.
assign(src, pos, count) vyberá časť reťazca alebo zdroja prevoditeľného na pohľad. Počet prvkov sa obmedzí na zvyšnú dĺžku; vynechanie count alebo hodnota npos znamená kopírovanie do konca. pos == size() dá prázdny výsledok, kým pos > size() zdroja vyvolá std::out_of_range. Obe šablóny pre pohľady (od C++17) vyžadujú implicitnú konverziu z const T& na príslušný std::basic_string_view. Iba šablóna pre celý zdroj vylučuje implicitnú konverziu z const T& na const CharT*; šablóna s pos a count toto obmedzenie nemá.
assign(count, ch) uloží count kópií ch, assign(first, last) skopíruje platný polootvorený rozsah vstupných iterátorov a assign({…}) skopíruje inicializačný zoznam. assign_range(r) je samostatná metóda z C++23; jej dostupnosť závisí od implementácie štandardnej knižnice.
Kopírovaním nevznikne pohľad do zdroja, ale zdrojové údaje musia byť platné počas čítania. Po úspešnom priradení znova získajte ukazovatele, referencie, iterátory a pohľady do pôvodného obsahu cieľa: mohli stratiť platnosť. Ak by výsledok presiahol max_size(), vyvolá sa std::length_error. Ak metóda vyvolá výnimku, cieľ zostane nezmenený; neplatný rozsah znamená nedefinované správanie, nie zaručenú výnimku.
Príklady
#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';
}Výsledok
size=3 preserved=yes
Kód porovná výsledok `find` s `npos` skôr, než vypočíta pozíciu za povinným oddeľovačom `:`. Buffer nemá koncový nulový znak; zadaná dĺžka umožní skopírovať všetky tri prvky poľa: `A`, `\0` a `B`.
Súvisiace lekcie
- C++ · Lekcia 58 · Pokročilá · Verzia: 3