Język C++
basic_string::append
[metoda] Modyfikuje przechowywany tekst poprzez dopisanie podanego łańcucha znaków na koniec tekstu.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;
typedef traits_type::char_type TypWartosci;
public:
UtworzonaKlasaT & append( const TypWartosci * _wsk );
UtworzonaKlasaT & append( const TypWartosci * _wsk, size_type _ilosc );
UtworzonaKlasaT & append( UtworzonaKlasaT & _str, size_type _przesuniecie, size_type _ilosc );
UtworzonaKlasaT & append( const UtworzonaKlasaT & _str );
UtworzonaKlasaT & append( size_type _ilosc, value_type _znak );
template < class WejsciowyIterator >
UtworzonaKlasaT & append( WejsciowyIterator _pierwszy, WejsciowyIterator _ostatni );
UtworzonaKlasaT & append( const_pointer _pierwszy, const_pointer _ostatni );
};
}
Argumenty
Zwracana wartość
Zwraca
referencję do obiektu na którym wykonywano operację (czyli:
return * this;
).
Opis szczegółowy
Metoda modyfikuje przechowywany tekst poprzez dopisanie podanego łańcucha znaków na koniec tekstu.
Jeżeli wyjątek zostanie rzucony to stan obiektu
nie ulegnie zmianie.
Dodatkowe informacje
Rzucane wyjątki
Jeżeli
_przesuniecie jest większe od długości
_str, to wtedy zostanie rzucony wyjątek
out_of_range.
Jeżeli wynik
length przekroczy
max_size, to zostanie rzucony wyjątek
length_error.
Jeżeli szablon korzysta z domyślnego alokatora oraz alokacja pamięci się nie powiedzie, to metoda rzuci wyjątkiem
bad_alloc.
Przykład
#include <string>
#include <iostream>
typedef std::basic_string < char, std::char_traits < char >, std::allocator < char >> MojString;
int main()
{
MojString str;
char * wsk = "To jest ";
str.append( wsk );
char * wsk2 = "napis, a to nie zostanie dodane";
str.append( wsk2, 5 );
MojString inny( "Tomek, ktory jest hydraulikiem..." );
str.append( inny, 5, 8 );
MojString inny2( "zostanie " );
str.append( inny2 );
MojString inny3( "XX wypisany dlugopis YY" );
str.append( inny3.begin() + 3, inny3.end() - 11 );
str.append( "na ekran" );
str.append( 3, '!' );
std::cout << str;
return 0;
}
Standardowe wyjście programu:
To jest napis, ktory zostanie wypisany na ekran!!!
Zagadnienia powiązane
operator+= | Dopisuje łańcuch znaków na koniec kontenera. (operator - metoda) |
---|
assign | Przypisuje nową wartość aktualnemu obiektowi. (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.