basic_string::substr

[metoda] Zwraca podciąg ł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 substr( size_type _pos = 0, size_type _len = npos ) const;

}; //class basic_string
} //namespace std

Argumenty

Argument	Opis
_pos	Pozycja pierwszego znaku nowego łańcucha znaków.
_len	Ilość znaków nowego łańcucha znaków. Wartość _{» standard C++ » basic_string ♦}npos spowoduje wykorzystanie wszystkich pozostałych znaków.

Zwracana wartość

Obiekt tego samego typu co aktualny zawierający podciąg znaków obiektu aktualnego.

Opis szczegółowy

Metoda zwraca nowy string, który powstał poprzez skopiowanie _len znaków od pozycji _pos aktualnego obiektu.

Rzucane wyjątki

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

Jeżeli _pos jest większe od długości aktualnego obiektu, to zostanie rzucony _{» standard C++ ♦}out_of_range.
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( "Naprawde bardzo dlugie zdanie z wieloma wyrazami!" );
MojString str2 = str.substr( 9, 20 );
std::cout << str2;
return 0;
}

Standardowe wyjście programu:

bardzo dlugie zdanie

Zagadnienia powiązane

replace	Zamienia część znaków na inne. (metoda)
data	Zwraca wskaźnik na początek tablicy znaków. (metoda)
find	Wyszukuje pierwszego wystąpienia danego łańcucha znaków. (metoda)
assign	Przypisuje nową wartość aktualnemu obiektowi. (metoda)
basic_string	Buduje nowy obiekt typu basic_string. (konstruktor)

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.