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