KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

Aan een tekenreeks toevoegen: std::basic_string::append

Kies de juiste overload van `append` voor een hele tekenreeks, een deel ervan of een buffer met bekende lengte. Voeg scheidingstekens expliciet toe en behoud interne nultekens.

Versie: 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 uit <string> voegt CharT-elementen toe aan het einde van een bestaande tekenreeks (std::string is de specialisatie voor char). De functie geeft *this terug als referentie, zodat je aanroepen kunt koppelen. Anders dan assign vervangt ze de bestaande inhoud niet en voegt ze niet automatisch scheidingstekens toe. Gebruik push_back(ch) of += ch voor één teken; push_back retourneert void.

append(str) kopieert de hele tekenreeks. append(str, pos, count) kopieert vanaf bronindex pos maximaal count elementen en stopt bij het einde van de bron. Laat count weg of geef npos mee om tot het einde te kopiëren. In de bron levert pos == size() een leeg deel op; pos > size() werpt std::out_of_range. De overloads voor view-achtige typen, beschikbaar sinds C++17, werken hetzelfde. In C++23 doen beide alleen mee aan de overloadselectie als const T& impliciet converteerbaar is naar std::basic_string_view<CharT, Traits>. Alleen de overload die de hele bron kopieert, vereist daarnaast dat const T& niet impliciet converteerbaar is naar const CharT*.

append(p) vereist een geldige, met een nulteken afgesloten reeks en kopieert tot aan het eerste nulteken, zonder dat teken mee te nemen. append(p, count) kopieert precies count elementen, inclusief interne nultekens. Het aantal wordt niet begrensd door de bufferlengte: controleer het tegen de werkelijke buffergrootte, want een ongeldig bereik leidt tot ongedefinieerd gedrag. Geef zowel data() als size() door aan een ontvanger die gegevens met een expliciete lengte accepteert.

append(count, ch) voegt count kopieën van ch toe. Je kunt ook een geldig bereik van invoeriterators [first, last) of een initialisatielijst doorgeven. Deze append-overloads zijn constexpr sinds C++20. append_range(range) is een aparte lidfunctie uit C++23; controleer of je standaardbibliotheek die ondersteunt.

Toevoegen kan pointers, referenties en iterators naar elementen van de doeltekenreeks ongeldig maken, en daarmee ook views op de opslag ervan. Vraag ze na de wijziging opnieuw op. Overschrijding van max_size() werpt std::length_error; geheugentoewijzing kan ook mislukken. Als een aanroep van append een uitzondering werpt, blijft de doeltekenreeks zoals die direct vóór die aanroep was.

Voorbeelden

#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";
}

Resultaat

accepted: 8 bytes

Het programma controleert op het verplichte `=` in de kop door het resultaat van `find` te vergelijken met `std::string::npos`. Daarna voegt het het deel vóór `=`, het expliciete scheidingsteken `:` en drie databytes toe. De ontvanger vergelijkt alle acht bytes, inclusief het interne `\0`. `append(payload)` zonder lengte zou alleen `A` kopiëren.

Gerelateerde lessen

  • C++ · Les 58 · Gevorderd · Versie: 3

Bronnen