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