База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

Добавяне в края на низ: std::basic_string::append

Избери претоварване на `append` според източника: цял низ, част от него или буфер с известна дължина. Добавяй разделителите изрично и запазвай нулевите знаци в данните.

Версия: ISO C++23; implementation support may vary

Синтаксис

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 от заглавния файл <string> добавя елементи от тип CharT в края на съществуващ низ (std::string е специализацията за char). Връща *this по референция, така че извикванията могат да се свързват във верига. За разлика от assign, не заменя съществуващото съдържание и не вмъква разделители автоматично. За един знак използвай push_back(ch) или += ch; push_back връща void.

append(str) копира целия низ. append(str, pos, count) копира най-много count елемента от индекс pos в източника, без да излиза извън края му. Пропусни count или подай npos, за да копираш до края. В източника pos == size() дава празен отрязък, а pos > size() хвърля std::out_of_range. Претоварванията за типове, преобразуеми до изглед, са налични от C++17 и действат по същия начин. В C++23 и двете участват в избора на претоварване само ако const T& може да се преобразува неявно до std::basic_string_view<CharT, Traits>. Само претоварването за целия източник има допълнително условие: const T& да не може да се преобразува неявно до const CharT*.

append(p) изисква валидна последователност, завършваща с нулев знак, и копира до първия нулев знак, без да го включва. append(p, count) копира точно count елемента, включително нулевите знаци в данните. Броят не се ограничава до дължината на буфера: провери го спрямо действителния размер на буфера, защото невалиден диапазон води до неопределено поведение. Подай и data(), и size() на получател, който приема данни с изрично зададена дължина.

append(count, ch) добавя count копия на ch. Можеш да подадеш и валиден диапазон от входни итератори [first, last) или инициализиращ списък. Тези претоварвания на append са constexpr от C++20. append_range(range) е отделна член-функция от C++23; провери дали стандартната ти библиотека я поддържа.

Добавянето може да направи невалидни указателите, референциите и итераторите към елементите на целевия низ, а с това и изгледите към неговата памет. Получи ги отново след промяната. Надхвърлянето на max_size() хвърля std::length_error; заделянето на памет също може да се провали. Ако извикване на append хвърли изключение, целевият низ остава в състоянието си непосредствено преди това извикване.

Примери

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

Резултат

accepted: 8 bytes

Програмата проверява за задължителния знак `=` в заглавната част, като сравнява резултата от `find` със `std::string::npos`. След това добавя отрязъка преди `=`, изрично зададения разделител `:` и три байта данни. Получателят сравнява всичките осем байта, включително вътрешния `\0`. Извикването `append(payload)` без дължина би копирало само `A`.

Свързани уроци

  • C++ · Урок 58 · Напреднало · Версия: 3

Източници