basic_string::erase

[metoda] Usuwa część stringa.

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 & erase( size_type _pos = 0, size_type _len = npos ); //(1)

iterator erase( const_iterator _p ); //(2)

iterator erase( const_iterator _pierwszy, const_iterator _ostatni ); //(3)

}; //class basic_string
} //namespace std

Argumenty

Argument	Opis
_pos	Pozycja pierwszego znaku do usunięcia.
_len	Maksymalna liczba znaków do usunięcia. Wartość _{» standard C++ » basic_string ♦}npos spowoduje usunięcie wszystkich pozostałych znaków.
_p	Iterator wskazujący znak do usunięcia.
_pierwszy	Iterator adresujący pierwszy element w przedziale, który ma zostać dodany na koniec.
_ostatni	Iterator adresujący pierwszy element za ostatnim z przedziału, który ma zostać dodany na koniec.

Zwracana wartość

Pierwsza metoda oznaczona przez (1) zwraca referencję do obiektu, na którym została wywołana (

* this

).
Pozostałe wersje metody zwracają iterator do pozycji znaku, który zajmuje teraz miejsce pierwszego usuniętego znaku. Jeżeli nie ma więcej znaków za usuniętym tekstem, iterator będzie wskazywał na _{» standard C++ » basic_string ♦}end.

Opis szczegółowy

Metody usuwające część stringu. Metoda (1) usuwa _len znaków (lub mniej w przypadku napotkania końca kontenera) od pozycji _pos. Metoda (2) usuwa pojedynczy znak wskazywany przez iterator _p. Metoda (3) usuwa cały przedział znaków określony przez [_pierwszy, _ostatni).

Rzucane wyjątki

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

Jeżeli _p lub przedział [_pierwszy, _ostatni) nie jest poprawny, zachowanie jest niezdefiniowane.

Jeżeli _pos jest większe od długości aktualnego obiektu, to wtedy zostanie rzucony _{» standard C++ ♦}out_of_range.

Przykład

#include <iostream>
#include <string>

typedef std::basic_string < char, std::char_traits < char >, std::allocator < char >> MojString;
int main()
{
MojString str( "To jest przykladowe zdanie." );
std::cout << str << '\n';
// "To jest przykladowe zdanie."
// ^^^^^^^^^^^^
str.erase( 8, 12 );
std::cout << str << '\n';
// "To jest zdanie."
// ^
str.erase( str.begin() + 8 );
std::cout << str << '\n';
// "To jest danie."
// ^^^^^
str.erase( str.begin() + 3, str.end() - 6 );
std::cout << str << '\n';
// "To danie."
return 0;
}

Standardowe wyjście programu:

To jest przykladowe zdanie.
To jest zdanie.
To jest danie.
To danie.

Zagadnienia powiązane

clear	Usuwa całą zawartość stringa. (metoda)
replace	Zamienia część znaków na inne. (metoda)
insert	Wstawia znaki do aktualnego łańcucha znaków. (metoda)
assign	Przypisuje nową wartość aktualnemu obiektowi. (metoda)
append	Modyfikuje przechowywany tekst poprzez dopisanie podanego łańcucha znaków na koniec tekstu. (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.