Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Aggiungere in coda a una stringa: std::basic_string::append

Scegli l’overload di `append` in base alla sorgente: una stringa intera, una porzione o un buffer di lunghezza nota. Aggiungi separatori espliciti e conserva i caratteri nulli interni.

Versione: ISO C++23; implementation support may vary

Sintassi

In <string>, for std::basic_string<CharT, Traits, Allocator> dst (C++23):
dst.append(str);                     // whole basic_string
dst.append(str, pos, count = npos);  // slice of a basic_string
dst.append(viewLike);                // whole view
dst.append(viewLike, pos, count = npos); // slice of a view
dst.append(p);                       // null-terminated sequence
dst.append(p, count);                // exactly count elements
dst.append(count, ch);               // count copies of ch
dst.append(first, last);              // valid input-iterator range [first, last)
dst.append({ch1, ch2});               // initializer list
All forms return basic_string&. The notation count = npos denotes a default argument, not an assignment at the call site. append_range(range) is a separate C++23 member.

std::basic_string::append, dichiarato in <string>, aggiunge elementi CharT in coda a una stringa esistente (std::string è la specializzazione per char). Restituisce *this per riferimento, così puoi concatenare più chiamate. A differenza di assign, non sostituisce il contenuto esistente e non inserisce separatori automaticamente. Per un solo carattere, usa push_back(ch) o += ch; push_back restituisce void.

append(str) copia tutta la stringa. append(str, pos, count) copia al massimo count elementi a partire dall’indice pos nella sorgente, senza oltrepassarne la fine. Ometti count o passa npos per copiare fino alla fine. Nella sorgente, pos == size() dà una porzione vuota; pos > size() lancia std::out_of_range. Gli overload per tipi convertibili in una vista, disponibili da C++17, funzionano allo stesso modo. In C++23, entrambi partecipano alla risoluzione degli overload solo se const T& è convertibile implicitamente in std::basic_string_view<CharT, Traits>. Solo l’overload che copia l’intera sorgente richiede inoltre che const T& non sia convertibile implicitamente in const CharT*.

append(p) richiede una sequenza valida terminata da un carattere nullo e copia fino al primo nullo, escluso. append(p, count) copia esattamente count elementi, inclusi i caratteri nulli interni. Non limita il conteggio alla lunghezza del buffer: verificalo rispetto alla dimensione effettiva del buffer, perché un intervallo non valido comporta un comportamento indefinito. Passa sia data() sia size() a un ricevitore che accetta dati con lunghezza esplicita.

append(count, ch) aggiunge count copie di ch. Puoi anche passare un intervallo valido di iteratori di input [first, last) o una lista di inizializzazione. Questi overload di append sono constexpr da C++20. append_range(range) è una funzione membro distinta introdotta in C++23; verifica che la tua libreria standard la supporti.

L’aggiunta può invalidare puntatori, riferimenti e iteratori agli elementi della stringa di destinazione, e quindi anche le viste sulla sua memoria. Ottienili di nuovo dopo la modifica. Superare max_size() provoca std::length_error; anche l’allocazione può fallire. Se una chiamata a append lancia un’eccezione, la stringa di destinazione resta com’era immediatamente prima di quella chiamata.

Esempi

#include <iostream>
#include <string>
#include <string_view>

int main() {
    const std::string header = "kind=sample";
    const char payload[] = {'A', '\0', 'B'};

    const auto cut = header.find('=');
    if (cut == std::string::npos) {
        return 1;
    }

    std::string message;
    message.append(header, 0, cut)
           .append(1, ':')
           .append(payload, sizeof payload);

    const std::string_view received{message.data(), message.size()};
    if (received != std::string_view{"kind:A\0B", 8}) {
        return 2;
    }

    std::cout << "accepted: " << received.size() << " bytes\n";
}

Risultato

accepted: 8 bytes

Il programma verifica la presenza di `=` nell’intestazione confrontando il risultato di `find` con `std::string::npos`. Poi aggiunge la porzione prima di `=`, il separatore esplicito `:` e tre byte di dati. Il ricevitore confronta tutti e otto i byte, incluso il `\0` interno. `append(payload)` senza lunghezza esplicita copierebbe solo `A`.

Lezioni correlate

  • C++ · Lezione 58 · Avanzato · Versione: 3

Fonti