CKTIS / C++
std::basic_string::assign — den Inhalt eines Strings ersetzen
Wähle die zur Quelle passende Überladung. Bei einem Puffer bekannter Länge bleiben mit Zeiger und Elementzahl auch eingebettete Nullzeichen erhalten.
Version: 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 aus <string> ersetzt den gesamten Inhalt eines vorhandenen Strings, etwa eines std::string. Die Methode gibt *this als Referenz zurück, sodass sich Aufrufe verketten lassen. Anders als append hängt sie nichts an. Die Überladungen für einen ganzen basic_string wirken wie Kopier- bzw. Verschiebezuweisung mit operator=. Beim Verschieben muss der Quellpuffer nicht übernommen werden; die noexcept-Bedingung hängt von den Allocator-Eigenschaften ab.
assign(p, count) kopiert genau count Elemente vom Typ CharT, einschließlich eingebetteter \0-Zeichen. [p, p + count) muss ein gültiger lesbarer Bereich sein; die Funktion prüft die Puffergröße nicht. Gleiche eine nicht vertrauenswürdige Längenangabe vor dem Aufruf mit den verfügbaren Daten ab. assign(p) verlangt dagegen einen gültigen nullterminierten String und kopiert nur bis zum ersten Nullzeichen, ohne dieses zu übernehmen.
assign(src, pos, count) übernimmt einen Ausschnitt aus einem String oder einer View-kompatiblen Quelle. Die Anzahl wird auf die Restlänge begrenzt; ohne count oder mit npos wird bis zum Ende kopiert. pos == size() ergibt einen leeren String; pos > size() der Quelle löst std::out_of_range aus. Beide View-Templates (seit C++17) setzen eine implizite Konvertierung von const T& zum passenden std::basic_string_view voraus. Nur das Template für die gesamte Quelle schließt eine implizite Konvertierung von const T& zu const CharT* aus; für das Template mit pos und count gilt diese Einschränkung nicht.
assign(count, ch) speichert count Kopien von ch, assign(first, last) kopiert einen gültigen halboffenen Bereich von Eingabeiteratoren, und assign({…}) kopiert eine Initialisierungsliste. assign_range(r) ist eine eigene Methode aus C++23; ihre Verfügbarkeit hängt von der Standardbibliothek ab.
Beim Kopieren entsteht keine View auf die Quelle, doch die Quelldaten müssen beim Lesen gültig bleiben. Ermittle Zeiger, Referenzen, Iteratoren und Views auf den bisherigen Zielinhalt nach erfolgreicher Zuweisung neu: Sie können ungültig geworden sein. Würde das Ergebnis max_size() überschreiten, wird std::length_error ausgelöst. Bei einer Ausnahme bleibt das Ziel unverändert; ein ungültiger Bereich führt zu undefiniertem Verhalten, nicht zu einer garantierten Ausnahme.
Beispiele
#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';
}Ergebnis
size=3 preserved=yes
Der Code prüft das Ergebnis von `find` auf `npos`, bevor er die Position hinter dem Pflichttrennzeichen `:` berechnet. Der Puffer hat kein abschließendes Nullzeichen; die explizite Länge kopiert alle drei Feldelemente `A`, `\0` und `B`.
Zugehörige Lektionen
- C++ · Lektion 58 · Fortgeschritten · Version: 3