База знанияИзпитен център
BGБългарски
Избери език13

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!!

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници