basic_string::operator+=

[operator - metoda] Dopisuje łańcuch znaków na koniec kontenera.

Składnia

#include <string>

namespace std
{
template <
class TypZnaku,
class CechowanieZnakow = char_traits < TypZnaku >,
class Alokator = allocator < TypZnaku >
>
class basic_string
{
private:
typedef basic_string < TypZnaku, CechowanieZnakow, Alokator > UtworzonaKlasaT;
public:
UtworzonaKlasaT & operator +=( const UtworzonaKlasaT & _str ); //(1)

UtworzonaKlasaT & operator +=( const TypZnaku * _s ); //(2)

UtworzonaKlasaT & operator +=( TypZnaku _znak ); //(3)

UtworzonaKlasaT & operator +=( initializer_list < TypZnaku > _il ); //(4)

}; //class basic_string
} //namespace std

Argumenty

Argument	Opis
_str	String, który ma zostać dopisany na koniec.
_s	Łańcuch znaków zakończony bajtem zerowym, który ma zostać dopisany na koniec.
_znak	Pojedynczy znak, który ma zostać dopisany na koniec.
_il	Obiekt typu _{» standard C++11 ♦}initializer_list.

Zwracana wartość

Operator zwraca referencję do obiektu, na którym został wywołany (

* this

Opis szczegółowy

Operator dopisuje nową treść na koniec ciągu. Może to uczynić na podstawie innego obiektu tego samego typu co aktualny (1), tablicy znaków wskazywanej wskaźnikiem (2), pojedynczego znaku (3) lub listy inicjalizacyjnej (4).

Rzucane wyjątki

Jeżeli wyjątek zostanie rzucony, wartość obiektu nie ulegnie zmianie.

Jeżeli wynik _{» standard C++ » basic_string ♦}length przekroczy _{» standard C++ » basic_string ♦}max_size, to zostanie rzucony _{» standard C++ ♦}length_error.
Jeżeli szablon korzysta z domyślnego alokatora, to _{» standard C++ ♦}bad_alloc zostanie rzucony, gdy funkcja będzie chcieć zaalokować pamięć i operacja się nie powiedzie.

Przykład

#include <iostream>
#include <string>

typedef std::basic_string < char, std::char_traits < char >, std::allocator < char >> MojString;
int main()
{
MojString imie( "Jan" );
MojString nazwisko( "Kowalski" );
imie += " M. "; // c-string
imie += nazwisko; // string
imie += '\n'; // znak

std::cout << imie;
return 0;
}

Standardowe wyjście programu:

Jan M. Kowalski

Zagadnienia powiązane

append	Modyfikuje przechowywany tekst poprzez dopisanie podanego łańcucha znaków na koniec tekstu. (metoda)
assign	Przypisuje nową wartość aktualnemu obiektowi. (metoda)
operator=	Przypisuje nową wartość aktualnemu obiektowi. (operator - metoda)
insert	Wstawia znaki do aktualnego łańcucha znaków. (metoda)
replace	Zamienia część znaków na inne. (metoda)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.