CKTIS / C++
An eine Zeichenkette anhängen: std::basic_string::append
Wähle die passende `append`-Überladung für eine ganze Zeichenkette, einen Ausschnitt oder einen Puffer bekannter Länge. Füge Trennzeichen ausdrücklich hinzu und erhalte eingebettete Nullzeichen.
Version: ISO C++23; implementation support may vary
Syntax
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 aus <string> fügt CharT-Elemente am Ende einer vorhandenen Zeichenkette hinzu (std::string ist die Spezialisierung für char). Die Funktion gibt *this als Referenz zurück, sodass sich Aufrufe verketten lassen. Anders als assign ersetzt sie den Inhalt nicht und fügt keine Trennzeichen automatisch ein. Für ein einzelnes Zeichen eignen sich push_back(ch) oder += ch; push_back gibt void zurück.
append(str) kopiert die ganze Zeichenkette. append(str, pos, count) kopiert ab Quellindex pos höchstens count Elemente und stoppt am Ende der Quelle. Ohne count oder mit npos wird bis zum Ende kopiert. Für die Quelle ergibt pos == size() einen leeren Ausschnitt; pos > size() löst std::out_of_range aus. Die seit C++17 verfügbaren Überladungen für View-ähnliche Typen funktionieren genauso. In C++23 nehmen beide nur dann an der Überladungsauflösung teil, wenn const T& implizit in std::basic_string_view<CharT, Traits> konvertierbar ist. Nur die Überladung für die gesamte Quelle setzt zusätzlich voraus, dass const T& nicht implizit in const CharT* konvertierbar ist.
append(p) benötigt eine gültige nullterminierte Folge und kopiert bis zum ersten Nullzeichen, ohne dieses mitzukopieren. append(p, count) kopiert genau count Elemente, auch eingebettete Nullzeichen. Die Anzahl wird nicht auf die Pufferlänge begrenzt: Prüfe sie anhand der tatsächlichen Puffergröße, denn ein ungültiger Bereich führt zu undefiniertem Verhalten. Übergib data() und size() an einen Empfänger, der Daten mit expliziter Länge entgegennimmt.
append(count, ch) hängt count Kopien von ch an. Auch ein gültiger Bereich [first, last) aus Eingabeiteratoren oder eine Initialisierungsliste ist möglich. Diese append-Überladungen sind seit C++20 constexpr. append_range(range) ist eine separate Memberfunktion aus C++23; prüfe, ob deine Standardbibliothek sie unterstützt.
Das Anhängen kann Zeiger, Referenzen und Iteratoren in die Zielzeichenkette und damit auch Views auf ihren Speicher ungültig machen. Hole sie nach der Änderung neu. Eine Überschreitung von max_size() löst std::length_error aus; auch die Speicherallokation kann scheitern. Wirft ein append-Aufruf eine Ausnahme, bleibt die Zielzeichenkette im Zustand unmittelbar vor diesem Aufruf.
Beispiele
#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";
}
Ergebnis
accepted: 8 bytes
Das Programm sucht das vorgeschriebene `=` im Header, indem es das Ergebnis von `find` mit `std::string::npos` vergleicht. Es hängt den Ausschnitt vor `=`, das explizite Trennzeichen `:` und drei Nutzdatenbytes an. Der Empfänger vergleicht alle acht Bytes einschließlich des eingebetteten `\0`. `append(payload)` ohne Längenangabe würde nur `A` kopieren.
Zugehörige Lektionen
- C++ · Lektion 58 · Fortgeschritten · Version: 3