CKTIS / C++
std::basic_string::assign — de inhoud van een string vervangen
Kies de overload die bij de bron past. Geef bij een buffer met bekende lengte een pointer en een aantal op om ook ingebedde nultekens te behouden.
Versie: 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 uit <string> vervangt de volledige inhoud van een bestaande string, zoals een std::string. De functie retourneert *this per referentie, zodat je aanroepen kunt koppelen. Anders dan append voegt ze niets achteraan toe. De overloads voor een volledige basic_string werken als kopieer- of verplaatstoewijzing met operator=. Bij verplaatsen hoeft de bronbuffer niet te worden overgenomen; de noexcept-voorwaarde hangt af van de allocatoreigenschappen.
assign(p, count) kopieert precies count CharT-elementen, inclusief ingebedde \0-tekens. [p, p + count) moet een geldig, leesbaar bereik zijn; de functie controleert de buffergrootte niet. Controleer vóór de aanroep of een onbetrouwbare lengte binnen de beschikbare gegevens valt. assign(p) vereist daarentegen een geldige nulbeëindigde string en kopieert tot het eerste nulteken, zonder dat teken mee te nemen.
assign(src, pos, count) neemt een deel van een string of van een bron die naar een view kan worden omgezet. Het aantal wordt begrensd door de resterende lengte; zonder count of met npos wordt tot het einde gekopieerd. pos == size() levert een leeg resultaat op; pos > size() van de bron leidt tot std::out_of_range. Beide view-templates (sinds C++17) vereisen impliciete conversie van const T& naar de passende std::basic_string_view. Alleen de template voor de volledige bron sluit impliciete conversie van const T& naar const CharT* uit; de template met pos en count heeft die beperking niet.
assign(count, ch) slaat count kopieën van ch op, assign(first, last) kopieert een geldig halfopen bereik van invoeriterators en assign({…}) kopieert een initialisatielijst. assign_range(r) is een aparte C++23-methode; de beschikbaarheid hangt af van de implementatie van de standaardbibliotheek.
De kopie houdt geen view op de bron vast, maar de brongegevens moeten tijdens het lezen geldig blijven. Haal pointers, referenties, iterators en views naar de oude inhoud van de doelstring na een geslaagde toewijzing opnieuw op: ze kunnen ongeldig zijn geworden. Een resultaat groter dan max_size() leidt tot std::length_error. Als de methode een exceptie werpt, blijft de doelstring ongewijzigd; een ongeldig bereik geeft ongedefinieerd gedrag, geen gegarandeerde exceptie.
Voorbeelden
#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';
}Resultaat
size=3 preserved=yes
De code vergelijkt het resultaat van `find` met `npos` voordat hij de positie na het verplichte scheidingsteken `:` berekent. De buffer heeft geen afsluitend nulteken; door de expliciete lengte worden alle drie de veldelementen gekopieerd: `A`, `\0` en `B`.
Gerelateerde lessen
- C++ · Les 58 · Gevorderd · Versie: 3