basic_string::insert

[metoda] Wstawia znaki do aktualnego łańcucha znaków.

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 & insert( size_type _pos, const UtworzonaKlasaT & _str ); //(1a)

UtworzonaKlasaT & insert( size_type _pos, const UtworzonaKlasaT & _str, size_type _subpos, size_type _sublen ); //(1b)

UtworzonaKlasaT & insert( size_type _pos, const charT * _s ); //(1c)

UtworzonaKlasaT & insert( size_type _pos, const charT * _s, size_type _n ); //(1d)

UtworzonaKlasaT & insert( size_type _pos, size_type _n, TypZnaku _c ); //(2a)
iterator insert( const_iterator _p, size_type _n, TypZnaku _c ); //(2b)

iterator insert( const_iterator _p, TypZnaku _c ); //(2c)

template < class WejsciowyIterator >
iterator insert( iterator _p, WejsciowyIterator _pierwszy, WejsciowyIterator _ostatni ); //(3)

UtworzonaKlasaT & insert( const_iterator _p, initializer_list < TypZnaku > _il ); //(4)
}; //class basic_string
} //namespace std

Argumenty

Argument	Opis
_pos	Punkt wstawienia nowych znaków. Nowa zawartość zostanie wstawiona przed znakiem pozycji _pos.
_str	Inny obiekt tego samego typu (z uwzględnieniem parametrów szablonu!).
_subpos	Pozycja pierwszego znaku podciągu w _str, który zostanie wstawiony.
_sublen	Maksymalna długość podciągu, który ma zostać skopiowany. Wartość _{» standard C++ » basic_string ♦}npos spowoduje wykorzystanie wszystkich pozostałych znaków.
_s	Wskaźnik na tablicę znaków.
_n	Liczba znaków do wstawienia.
_c	Pojedynczy znak do wstawienia.
_p	Iterator wskazujący miejsce wstawienia. Nowy zawartość zostanie wstawiona przed znak wskazywany przez _p.
_pierwszy, _ostatni	Przedział [_pierwszy, _ostatni) określający łańcuch znaków do wstawienia.
_il	Obiekt _{» standard C++11 ♦}initializer_list. To co zostanie z niego skonstruowane będzie wstawione do aktualnego stringa.

Zwracana wartość

Sygnatury funkcji zwracające referencję do UtworzonaKlasaT zwracają

* this

.
Te zwracające iterator zwracają iterator wskazujący na pierwszy wstawiony znak.

Opis szczegółowy

Metody (1) wstawiają tekst na pozycję _pos. Wstawiany tekst może być innym stringiem (1a), jego częścią (1b), wskaźnikiem do tablicy znaków (1c) lub częścią owej tablicy (1d). Metody (2) wstawiają _n znaków o wartości _c przed znak określony indeksem _pos lub iteratorem _p. Wyjątkiem jest funckja (2c), która wstawia tylko jeden znak. Metoda (3) wstawia znaki z przedziału [_pierwszy, _ostatni) przed znak określony iteratorem _p. Metoda (4) wstawia zawartość obiektu zbudowanego na podstawie listy inicjalizacyjnej na pozycję _p aktualnego obiektu.

Rzucane wyjątki

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

Jeżeli _s nie wskazuje na wystarczająco dużą tablicę (_n jest za duże) lub _p albo przedział [_pierwszy, _ostatni) jest niepoprawny, to zachowanie jest niezdefiniowane.

Jeżeli _pos jest większe od długości aktualnego obiektu albo _subpos jest większe od długości _str, to zostanie wtedy rzucony _{» standard C++ ♦}out_of_range.
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 str = "byc pytanie";
MojString str2 = "albo nie byc drzewem";
MojString::iterator it;

str.insert( 4, str2, 5, 8 ); // byc (nie byc )pytanie
str.insert( 12, "oto jest moj zamek", 9 ); // byc nie byc (oto jest )pytanie
str.insert( 11, 1, ':' ); // byc nie byc(:) oto jest pytanie
str.insert( str.end(), 3, '.' ); // byc nie byc: oto jest pytanie(...)
it = str.insert( str.begin() + 3, ',' ); // byc(,) nie byc: oto jest pytanie...
str.insert( it + 2, str2.begin(), str2.begin() + 5 ); // byc, (albo )nie byc: oto jest pytanie...

std::cout << str << '\n';
return 0;
}

Standardowe wyjście programu:

byc, albo nie byc: oto jest pytanie...

Zagadnienia powiązane

append	Modyfikuje przechowywany tekst poprzez dopisanie podanego łańcucha znaków na koniec tekstu. (metoda)
replace	Zamienia część znaków na inne. (metoda)
substr	Zwraca podciąg łańcucha znaków. (metoda)
operator=	Przypisuje nową wartość aktualnemu obiektowi. (operator - metoda)
operator+=	Dopisuje łańcuch znaków na koniec kontenera. (operator - 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.