CKTIS / C++
std::basic_string::push_back — één code-eenheid toevoegen
Voeg één code-eenheid achteraan een tekenreeks toe, rechtstreeks of via een uitvoeriterator, en behoud nultekens in gegevens met een bekende lengte.
Versie: ISO C++23; implementation support may vary
Syntax
constexpr void push_back(CharT ch);std::basic_string::push_back is een niet-const lidfunctie uit <string> en is sinds C++20 constexpr. Ze neemt één CharT op waarde aan (char voor std::string), voegt die achteraan toe, ook bij een lege tekenreeks, verhoogt size() met één en retourneert void. Er is geen overload voor een tekenreeks of bereik. s.append(1, ch) en s += ch hebben hetzelfde effect, maar retourneren een referentie naar s. Gebruik s.append(p, n) voor een geldig bereik van n elementen vanaf p.
Eén aanroep voegt één code-eenheid toe, niet noodzakelijk een heel Unicode-teken, en codeert of valideert geen tekst. In std::string behoort een toegevoegde '\0' tot de inhoud en telt die mee in size(). Dit is niet het extra afsluitteken op s.data()[s.size()]. Geef bij gegevens met ingebedde nultekens zowel data() als size() door aan een interface die de lengte respecteert.
Toevoegen kost geamortiseerd constante tijd, maar een afzonderlijke aanroep kan geheugen toewijzen en bestaande inhoud verplaatsen. reserve() vóór een reeks toevoegingen kan het aantal allocaties verminderen. Door de wijziging kunnen pointers, referenties en iterators naar elementen ongeldig worden; haal ze daarna opnieuw op, ook de pointer uit data(). Als max_size() zou worden overschreden, volgt std::length_error. Ook geheugentoewijzing kan mislukken. Als de aanroep een uitzondering opwerpt, blijft de tekenreeks ongewijzigd.
std::back_inserter(s) uit <iterator> maakt een uitvoeriterator van het type std::back_insert_iterator. Een toewijzing zoals *out++ = ch roept s.push_back(ch) aan in plaats van een bestaand element te overschrijven. De adapter verwijst naar het tekenreeksobject, niet naar de buffer. Het object moet tijdens het schrijven blijven bestaan, en de adapter voorkomt geen allocaties.
Voorbeelden
#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';
}
Resultaat
ID: size: 6 embedded NUL: true
`push_back(':')` voegt het scheidingsteken toe. Met de adapter voegt `std::copy` alle drie de elementen van het bereik met expliciete lengte toe. De lengtecontrole beveiligt het lezen op index 4, zodat het nul-teken kan worden bevestigd zonder het af te drukken.
Gerelateerde lessen
- C++ · Les 46 · Gevorderd · Versie: 3
- C++ · Les 53 · Gevorderd · Versie: 3
- C++ · Les 58 · Gevorderd · Versie: 3
Bronnen
- [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++