CKTIS / C++
std::basic_string::assign — zamjena sadržaja niza znakova
Odaberi preopterećenje prema izvoru. Za međuspremnik poznate duljine predaj pokazivač i broj elemenata kako bi se sačuvali i nul-znakovi unutar podataka.
Verzija: ISO C++23; implementation support may vary
Sintaksa
// 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 iz zaglavlja <string> zamjenjuje sav sadržaj postojećeg niza znakova, primjerice std::string. Vraća *this kao referencu, pa se pozivi mogu ulančati. Za razliku od append, ne dodaje na kraj. Preopterećenja za cijeli basic_string ponašaju se kao operator= za kopiranje ili premještanje. Premještanje ne jamči preuzimanje izvornog međuspremnika, a njegov uvjet noexcept ovisi o svojstvima alokatora.
assign(p, count) kopira točno count elemenata tipa CharT, uključujući unutarnje znakove \0. [p, p + count) mora biti valjan čitljiv raspon; funkcija ne provjerava veličinu međuspremnika. Prije poziva provjeri nepouzdanu duljinu u odnosu na dostupne podatke. Nasuprot tomu, assign(p) zahtijeva valjan niz završen nul-znakom i kopira samo do prvog nul-znaka, bez njega.
assign(src, pos, count) uzima dio niza ili izvora pretvorivog u pogled. Broj elemenata ograničen je preostalom duljinom; izostavljanje count ili zadavanje npos znači kopiranje do kraja. pos == size() daje prazan rezultat, a pos > size() izvora izaziva std::out_of_range. Oba predloška za poglede (od C++17) zahtijevaju implicitnu pretvorbu iz const T& u odgovarajući std::basic_string_view. Samo predložak za cijeli izvor isključuje implicitnu pretvorbu iz const T& u const CharT*; predložak s pos i count nema to ograničenje.
assign(count, ch) pohranjuje count kopija znaka ch, assign(first, last) kopira valjan poluotvoreni raspon ulaznih iteratora, a assign({…}) kopira inicijalizacijski popis. assign_range(r) zasebna je metoda iz C++23; njezina dostupnost ovisi o implementaciji standardne biblioteke.
Kopija ne zadržava pogled na izvor, no izvorni podaci moraju ostati valjani tijekom čitanja. Nakon uspješne dodjele ponovno dohvati pokazivače, reference, iteratore i poglede na prethodni sadržaj odredišta: možda više nisu valjani. Rezultat koji bi premašio max_size() izaziva std::length_error. Ako metoda baci iznimku, odredište ostaje nepromijenjeno; nevaljan raspon znači nedefinirano ponašanje, a ne zajamčenu iznimku.
Primjeri
#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';
}Rezultat
size=3 preserved=yes
Kôd uspoređuje rezultat `find` s `npos` prije izračuna položaja iza obveznog razdjelnika `:`. Međuspremnik nema završni nul-znak; zadana duljina omogućuje kopiranje sva tri elementa polja: `A`, `\0` i `B`.
Povezane lekcije
- C++ · Lekcija 58 · Napredno · Verzija: 3