Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::basic_string::operator+= — dopisywanie do napisu

std::basic_string::operator+= dopisuje znaki na końcu istniejącego napisu i zwraca referencję do niego. Obsługuje inny napis, pojedynczy znak, napis zakończony zerem, listę inicjalizacyjną oraz typ zgodny z widokiem napisu.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

constexpr basic_string& operator+=(const basic_string& str);
template<class T> constexpr basic_string& operator+=(const T& t);
constexpr basic_string& operator+=(const charT* s);
constexpr basic_string& operator+=(charT c);
constexpr basic_string& operator+=(std::initializer_list<charT> il);

std::basic_string::operator+= zmienia lewy argument, dopisując zawartość na jego końcu. Dla std::string typem charT jest char; wymagany jest nagłówek <string>. Wynik ma typ basic_string& i wskazuje ten sam obiekt, co pozwala pisać (text += "a") += "b".

Pięć przeciążeń przyjmuje: const basic_string&, const charT*, charT, std::initializer_list<charT> oraz const T&. Ostatnie uczestniczy w wyborze przeciążenia tylko wtedy, gdy const T& jest konwertowalne do std::basic_string_view<charT, traits>, ale nie do const charT*. Operacje odpowiadają wywołaniom append; wariant znakowy dopisuje dokładnie jeden znak.

Wariant wskaźnikowy wymaga poprawnego napisu zakończonego zerem i kończy kopiowanie przed pierwszym znakiem zerowym; nie przekazuj pustego wskaźnika. Warianty przyjmujące napis lub widok zachowują osadzone znaki zerowe dzięki jawnej długości. Aby dopisać bufor o znanym rozmiarze, użyj append(data, count).

Dopisanie może wymagać alokacji oraz unieważnić referencje, wskaźniki i iteratory do elementów. Przekroczenie max_size() powoduje std::length_error; jeśli operacja zgłosi wyjątek, obiekt napisu pozostaje bez zmian. Podane źródła przedstawiają rozwijany szkic standardu, a nie zamrożony tekst C++23.

Przykłady

#include <iostream>
#include <string>
#include <string_view>

int main() {
    std::string text = "C";
    text += std::string("++");
    text += ' ';
    text += "is";
    text += std::string_view(" useful");
    (text += {'!', '!'}) += '\n';
    std::cout << text;
}

Wynik

C++ is useful!!

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła