Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

Dopisywanie do łańcucha: std::basic_string::append

Dobierz przeciążenie `append` do postaci źródła: całego łańcucha, jego fragmentu albo bufora o znanej długości. Dopisuj separatory jawnie i zachowuj wewnętrzne znaki zerowe.

Wersja: ISO C++23; implementation support may vary

Składnia

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 z nagłówka <string> dopisuje elementy CharT na końcu istniejącego łańcucha (std::string to specjalizacja dla char). Zwraca *this przez referencję, więc wywołania można łączyć. Nie zastępuje dotychczasowej zawartości jak assign i nie wstawia separatora automatycznie. Jeden znak można dopisać przez push_back(ch) lub += ch; push_back zwraca void.

append(str) kopiuje cały łańcuch. append(str, pos, count) kopiuje od indeksu pos najwyżej count elementów, nie wychodząc poza koniec źródła. Pominięcie count lub podanie npos oznacza kopiowanie do końca. pos == size() źródła daje pusty fragment, a pos > size() powoduje std::out_of_range. Przeciążenia dla widoków, dostępne od C++17, działają analogicznie. W C++23 oba uczestniczą w wyborze przeciążenia tylko wtedy, gdy const T& można niejawnie przekonwertować na std::basic_string_view<CharT, Traits>. Tylko wersja dopisująca całe źródło wymaga dodatkowo, by const T& nie dało się niejawnie przekonwertować na const CharT*.

append(p) wymaga poprawnego łańcucha zakończonego znakiem zerowym i kopiuje dane do pierwszego zera, bez niego. append(p, count) kopiuje dokładnie count elementów, także zera wewnątrz zakresu. Nie ogranicza długości do rozmiaru bufora: sprawdź liczbę elementów względem rzeczywistego rozmiaru bufora, ponieważ niepoprawny zakres oznacza niezdefiniowane zachowanie. Przekaż odbiorcy oczekującemu danych o znanej długości zarówno data(), jak i size().

append(count, ch) dopisuje count kopii ch. Można też przekazać poprawny zakres iteratorów wejściowych [first, last) lub listę inicjalizacyjną. Te przeciążenia append są constexpr od C++20. append_range(range) to osobna funkcja składowa z C++23; sprawdź, czy Twoja biblioteka standardowa ją obsługuje.

Dopisanie może unieważnić wskaźniki, referencje i iteratory do elementów łańcucha docelowego, a tym samym widoki oparte na jego buforze. Po modyfikacji pobierz je ponownie. Przekroczenie max_size() powoduje std::length_error; alokacja pamięci też może się nie udać. Jeśli wywołanie append zgłosi wyjątek, pozostawia łańcuch docelowy bez zmian względem stanu sprzed tego wywołania.

Przykłady

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

Wynik

accepted: 8 bytes

Program sprawdza, czy nagłówek zawiera wymagany znak `=`, porównując wynik `find` z `std::string::npos`. Następnie dopisuje fragment przed `=`, jawny separator `:` i trzy bajty bufora. Odbiorca porównuje wszystkie osiem bajtów, także wewnętrzne `\0`. Wywołanie `append(payload)` zamiast wersji z długością skopiowałoby tylko `A`.

Powiązane lekcje

  • C++ · Lekcja 58 · Zaawansowany · Wersja: 3

Źródła