CKTIS / C++
std::basic_string::operator+= — добавяне към низ
std::basic_string::operator+= добавя знаци в края на съществуващ низ и връща препратка към него. Приема друг низ, един знак, низ, завършващ с нулев знак, инициализационен списък или тип, съвместим със string_view.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
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+= променя левия операнд, като добавя съдържание в края му. За std::string charT е char; включете <string>. Резултатът е от тип basic_string& и се отнася до същия обект, което позволява изрази като (text += "a") += "b".
Петте претоварвания приемат const basic_string&, const charT*, charT, std::initializer_list<charT> и const T&. Последното участва в избора на претоварване само ако const T& може да се преобразува към std::basic_string_view<charT, traits>, но не и към const charT*. Операциите съответстват на извиквания на append; претоварването за знак добавя точно един знак.
Претоварването с указател изисква валиден низ, завършващ с нулев знак, и спира копирането преди първия нулев знак; не подавайте нулев указател. Претоварванията за низ и изглед запазват вградените нулеви знаци благодарение на изричните си дължини. За да добавите буфер с известен размер, използвайте append(data, count).
Добавянето може да задели памет и да обезсили препратки, указатели и итератори към елементите. Надхвърлянето на max_size() предизвиква std::length_error; ако операцията хвърли изключение, обектът низ остава непроменен. Предоставените източници представят развиващия се проект на стандарта, а не окончателен текст на C++23.
Примери
#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;
}
Резултат
C++ is useful!!
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.