basic_string::at

[metoda] Zwraca referencję do danego znaku.

Składnia

#include <string>

namespace std
{
template <
class TypZnaku,
class CechowanieZnakow = char_traits < TypZnaku >,
class Alokator = allocator < TypZnaku >
>
class basic_string
{
private:
typedef traits_type::char_type TypWartosci;
typedef TypWartosci & Referencja;
typedef const TypWartosci & StalaReferencja;
public:
Referencja & at( size_type _pos );

StalaReferencja & at( size_type _pos ) const;

}; //class basic_string
} //namespace std

Argumenty

Argument	Opis
_pos	Pozycja elementu (znaku) w stringu.

Zwracana wartość

Metoda zwraca referencję do obiektu (znaku) na _pos-tej pozycji. Jeżeli obiekt jest stały, to metoda zwraca StalaReferencja, w przeciwnym wypadku zwracanym typem jest Referencja.

Opis szczegółowy

Metoda zwraca referencję do obiektu (znaku) na określonej pozycji.

Rzucane wyjątki

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

Jeżeli _pos przekroczy wartość zwracaną przez _{» standard C++ » basic_string ♦}length, to zostanie rzucony _{» standard C++ ♦}length_error.

Przykład

#include <string>
#include <iostream>

typedef std::basic_string < char, std::char_traits < char >, std::allocator < char >> MojString;
int main()
{
MojString str( "abc" );
std::cout << str.at( 1 );
}

Standardowe wyjście programu:

Zagadnienia powiązane

operator[]	Zwraca referencję do danego elementu stringa. (operator - metoda)
substr	Zwraca podciąg łańcucha znaków. (metoda)
find	Wyszukuje pierwszego wystąpienia danego ł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.