CKTIS / C++
std::basic_string::push_back — aggiungere un’unità di codice
Aggiungi un’unità di codice in coda a una stringa, direttamente o tramite un iteratore di output, senza perdere i caratteri nulli nei dati di lunghezza nota.
Versione: ISO C++23; implementation support may vary
Sintassi
constexpr void push_back(CharT ch);std::basic_string::push_back è una funzione membro non const dichiarata in <string> ed è constexpr da C++20. Riceve un CharT per valore (char per std::string), lo aggiunge in coda anche a una stringa vuota, incrementa size() di uno e restituisce void. Non ha overload per stringhe o intervalli. s.append(1, ch) e s += ch hanno lo stesso effetto, ma restituiscono un riferimento a s. Per aggiungere un intervallo valido di n elementi a partire da p, usa s.append(p, n).
Una chiamata aggiunge un’unità di codice, non necessariamente un intero carattere Unicode, e non codifica né convalida il testo. In std::string, un '\0' aggiunto fa parte del contenuto e conta in size(). È distinto dal terminatore aggiuntivo in s.data()[s.size()]. Per dati con caratteri nulli interni, passa data() e size() a un’interfaccia che rispetta la lunghezza.
L’aggiunta richiede tempo costante ammortizzato, ma una singola chiamata può allocare memoria e spostare il contenuto esistente. Chiamare reserve() prima di una serie di aggiunte può ridurre le allocazioni. La modifica può invalidare puntatori, riferimenti e iteratori agli elementi: ottienili di nuovo dopo l’aggiunta, incluso il puntatore di data(). Superare max_size() provoca un’eccezione std::length_error; anche l’allocazione può fallire. Se la chiamata solleva un’eccezione, la stringa resta invariata.
std::back_inserter(s), da <iterator>, crea un iteratore di output di tipo std::back_insert_iterator. Un’assegnazione come *out++ = ch chiama s.push_back(ch) invece di sovrascrivere un elemento esistente. L’adattatore fa riferimento all’oggetto stringa, non al suo buffer. La stringa deve restare in vita durante la scrittura e l’adattatore non impedisce le allocazioni.
Esempi
#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';
}
Risultato
ID: size: 6 embedded NUL: true
`push_back(':')` aggiunge il separatore, poi `std::copy` usa l’adattatore per aggiungere tutti e tre gli elementi dell’intervallo di lunghezza esplicita. Il controllo della dimensione protegge la lettura all’indice 4, che conferma il carattere nullo senza stamparlo.
Lezioni correlate
- C++ · Lezione 46 · Avanzato · Versione: 3
- C++ · Lezione 53 · Avanzato · Versione: 3
- C++ · Lezione 58 · Avanzato · Versione: 3
Fonti
- [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++