Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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