CKTIS / C++
std::basic_string::push_back — eine Codeeinheit anhängen
Eine Codeeinheit direkt oder über einen Ausgabeiterator anhängen und dabei eingebettete Nullzeichen sowie die Gültigkeit von Zeigern im Blick behalten.
Version: ISO C++23; implementation support may vary
Syntax
constexpr void push_back(CharT ch);std::basic_string::push_back ist eine nicht-konstante Memberfunktion aus <string> und seit C++20 constexpr. Sie nimmt einen Wert vom Typ CharT entgegen (char bei std::string), hängt ihn auch an eine leere Zeichenkette an, erhöht size() um eins und gibt void zurück. Es gibt keine Überladung für Zeichenketten oder Bereiche. s.append(1, ch) und s += ch haben dieselbe Wirkung, geben aber eine Referenz auf s zurück. Für einen gültigen Bereich von n Elementen ab p verwende s.append(p, n).
Ein Aufruf fügt eine Codeeinheit hinzu, nicht unbedingt ein ganzes Unicode-Zeichen, und kodiert oder validiert keinen Text. Bei std::string gehört ein angehängtes '\0' zum Inhalt und zählt bei size() mit. Es ist nicht das zusätzliche Abschlusszeichen bei s.data()[s.size()]. Übergib bei eingebetteten Nullzeichen data() und size() an eine Schnittstelle, die die Länge berücksichtigt.
Das Anhängen dauert amortisiert konstante Zeit. Ein einzelner Aufruf kann jedoch Speicher zuweisen und den bisherigen Inhalt verschieben. reserve() vor einer Reihe von Anhängevorgängen kann Zuweisungen reduzieren. Die Änderung kann Zeiger, Referenzen und Iteratoren auf Elemente ungültig machen; ermittle sie danach neu, auch den Zeiger von data(). Wird max_size() überschritten, wird std::length_error ausgelöst. Auch die Speicherzuweisung kann fehlschlagen. Löst der Aufruf eine Ausnahme aus, bleibt die Zeichenkette unverändert.
std::back_inserter(s) aus <iterator> erzeugt einen Ausgabeiterator vom Typ std::back_insert_iterator. Eine Wertzuweisung wie *out++ = ch ruft s.push_back(ch) auf, statt ein vorhandenes Element zu überschreiben. Der Adapter verweist auf das Zeichenkettenobjekt, nicht auf dessen Puffer. Das Objekt muss beim Schreiben noch existieren; der Adapter verhindert keine Speicherzuweisungen.
Beispiele
#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
#include <string_view>
int main() {
constexpr std::string_view payload{"4\0" "2", 3};
std::string record{"ID"};
record.push_back(':');
std::copy(payload.begin(), payload.end(), std::back_inserter(record));
const bool has_embedded_nul = record.size() == 6 && record.data()[4] == '\0';
std::cout << record.substr(0, 3) << '\n'
<< "size: " << static_cast<unsigned long long>(record.size()) << '\n'
<< "embedded NUL: " << std::boolalpha << has_embedded_nul << '\n';
}
Ergebnis
ID: size: 6 embedded NUL: true
`push_back(':')` fügt das Trennzeichen ein. Danach hängt `std::copy` über den Adapter alle drei Elemente des Bereichs mit expliziter Länge an. Die Längenprüfung sichert den Zugriff auf Index 4 ab, um das eingebettete Nullzeichen zu bestätigen, ohne es auszugeben.
Zugehörige Lektionen
- C++ · Lektion 46 · Fortgeschritten · Version: 3
- C++ · Lektion 53 · Fortgeschritten · Version: 3
- C++ · Lektion 58 · Fortgeschritten · Version: 3
Quellen
- [string.append] — basic_string::append and push_back
- [string.op.append] — basic_string::operator+=
- [string.require] — basic_string general requirements
- [basic.string.general] — basic_string storage and terminator
- [string.capacity] — basic_string size, capacity and reserve
- [back.insert.iterator] — back_insert_iterator and back_inserter
- std::basic_string<CharT,Traits,Allocator>::push_back — cppreference
- N4950 — Working Draft, Standard for Programming Language C++