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.