basic_string Class

Artykuł
03/15/2013

Sekwencje kontrolowane przez obiekt szablonu klasy basic_string są klasy string Standard C++ i są zwykle określane jako ciągi znaków, ale nie powinny być mylone z zakończonym znakiem null C-ciągi używane w całym standardowa biblioteka języka C++.Klasa string jest kontenerem, który umożliwia korzystanie z ciągów znaków jako normalne typów, takich jak przy użyciu operacji porównywania i łączenia, Iteratory i algorytmy STL i kopiowanie i przypisywanie z klasy alokatora zarządzane pamięci.

template <
   class CharType,
   class Traits=char_traits<CharType>, 
   class Allocator=allocator<CharType> 
>
class basic_string

Parametry

CharType
Typ danych o jeden znak w ciągu.Standardowa biblioteka języka C++ udostępnia dwa kierunki tej klasy szablonu z definicji typu string, dla elementów typu char, i wstring, dla elementów typu wchar_t.
Traits
Różne istotne właściwości CharType elementy specjalizacji basic_string są opisane przez klasę cech.
Allocator
Typ, który reprezentuje obiekt przechowywane alokatora mieszczącą się szczegółowe informacje o alokacji i dezalokacji pamięci ciąg.Wartością domyślną jest programu przydzielania*<Type>.*

Wiele funkcji elementów członkowskich wymagają sekwencji operand elementów.Można określić takie operand sekwencji na kilka sposobów.

Element	Opis
_Ch	Jeden element o wartość znaku _Ch.
_Count, _Ch	Powtórzenia _Count elementów z wartością _Ch.
_Ptr	Sekwencja zakończony znakiem null, takie jak ciąg c z CharType typu char, początkowe na _Ptr (który musi być wskaźnik zerowy), gdzie element zakończeń jest wartość value_type i nie jest częścią sekwencji operandu.
_Ptr, _Count	Sekwencja _Count elementów, począwszy od _Ptr.
_Str	Sekwencja, określony przez obiekt basic_string.
_Str, _Off, _Count	Podciąg obiektu basic_string _Str z maksymalnie _Count elementów (lub do końca ciągu nastąpi najpierw) począwszy od pozycji _Off.
_First, _Last	Sekwencja elementów rozdzielone Iteratory _First i _Last, w zakresie [_First, _Last), które mogą się pokrywać sekwencji kontrolowane przez obiekt string o nazwie którego funkcji składowej.

Jeśli argument pozycja (takie jak _Off) znajduje się poza koniec ciągu na wywołanie basic_string funkcji składowej funkcji zgłasza błąd spoza zakresu przez rzuca obiektu typu out_of_range klasy.

Jeśli funkcja jest proszony o wygenerować sekwencję dłużej niż max_size elementy, funkcja zgłasza błąd długość przez rzuca obiektu typu length_error klasy.

Odwołania, wskaźników i Iteratory wyznaczonych elementy sekwencji kontrolowanych przez może stać się nieprawidłowe po każde wywołanie funkcji, która zmienia sekwencję kontrolowanych lub po pierwsze wywołanie innego niż-const funkcji składowej.

Konstruktory

basic_string

Konstrukcje ciąg, który jest pusta lub zainicjowany przez określone znaki lub oznacza to kopii całości lub części innych obiektów w ciągu lub ciąg C.

Definicje TypeDef

allocator_type	Typ, który reprezentuje allocator klasy obiektu string.
const_iterator	Typ, który zapewnia iteratora losowy dostęp można uzyskać dostęp i odczytać const element w ciągu.
const_pointer	Typ, który zawiera wskaźnik do const element w ciągu.
const_reference	Typ, który zawiera odniesienie do const przechowywane w ciągu do odczytu i wykonywania elementu const operacji.
const_reverse_iterator	Typ, który zapewnia iteratora random access, których może odczytać dowolny const element w ciągu.
difference_type	Typ, który stanowi różnicę między dwoma Iteratory, odwołujących się do elementów w tym samym ciągu.
iteratora	Typ, który zapewnia iteratora random access mogą odczytywać lub modyfikować dowolnego elementu w ciągu.
nienastawionych	Niepodpisane wartości integralną, można zainicjować –1, która wskazuje albo "nie znaleziono" lub "wszystkie pozostałe znaki" Kiedy funkcja wyszukiwania nie powiedzie się.
wskaźnik	Typ, który zawiera wskaźnik do elementu znaku w tablicy ciąg znaków lub znaku.
Odwołanie	Typ, który zawiera odwołanie do elementu, przechowywane w postaci ciągu.
reverse_iterator	Typ, który zapewnia iteratora random access mogą odczytywać lub modyfikować elementu w ciągu wycofana.
size_type	Niepodpisane typ Liczba elementów w ciągu.
traits_type	Typ dla cech znak elementy przechowywane w postaci ciągu.
value_type	Typ, który reprezentuje typ przechowywanych w ciągu znaków.

Funkcje składowe

Dołącz	Dodaje znaki do końca ciągu.
Przypisywanie	Przypisuje nowy znak wartości zawartość ciągiem.
na	Zwraca odwołanie do elementu w określonej lokalizacji w ciągu.
Wstecz
Rozpocznij	Zwraca iterację adresowania w ciągu pierwszego elementu.
c_str	Konwertuje ciąg zawartości jako ciąg zakończony zerem, C-styl.
pojemność	Zwraca największą liczbę elementów, które może być przechowywany w ciągu bez zwiększania alokacji pamięci ciągu.
cbegin	Zwraca iteratora const, adresowania w ciągu pierwszego elementu.
cend	Zwraca iteratora const, likwidującą lokalizacji przejmującej w ciągu ostatniego elementu.
Wyczyść	Usuwa wszystkie elementy ciąg.
Porównaj	Porównanie ciągu określonego ciągu znaków, aby stwierdzić, czy dwa ciągi są równe, albo jeśli jest lexicographically mniej niż inne.
Kopiuj	Kopiuje najwyżej określoną liczbę znaków od pozycji indeksowane w ciągu źródła docelowej tablicy znaków.Przestarzałe.Użyj basic_string::_Copy_s zamiast.
crbegin	Zwraca iteratora const, likwidującą pierwszy element w ciągu wycofana.
użytkownika: crend	Zwraca iteratora const, likwidującą lokalizacji przejmującej ostatni element w ciągu wycofana.
_Copy_s	Kopiuje najwyżej określoną liczbę znaków od pozycji indeksowane w ciągu źródła docelowej tablicy znaków.
dane	Konwertuje ciąg zawartości do tablicy znaków.
pusty	Sprawdza, czy ciąg zawiera znaki.
koniec	Zwraca iterację, który dotyczy lokalizacji przejmującej w ciągu ostatniego elementu.
Wymaż	Usuwa element lub zakres elementów w ciągu od określonej pozycji.
Znajdź	Wyszukuje ciąg w kierunku do przodu dla pierwszego wystąpienia podciąg, który odpowiada określonej sekwencji znaków.
find_first_not_of	Wyszukiwanie w łańcuchu pierwszego znaku, który nie jest każdy element określony ciąg.
find_first_of	Wyszukiwanie w łańcuchu pierwszego znaku, który pasuje do dowolnego elementu określony ciąg.
find_last_not_of	Wyszukiwanie w łańcuchu ostatni znak, który nie jest każdy element określony ciąg.
find_last_of	Wyszukiwanie w łańcuchu ostatniego znaku, który jest elementem określony ciąg.
przednie	Zwraca odwołanie do pierwszego elementu w ciągu.
get_allocator	Zwraca kopię allocator obiekt używany do skonstruowania ciągu.
Wstaw	Wstawia element lub liczba elementów lub zakres elementów do ciągu w określonym położeniu.
długość	Zwraca bieżącą liczbę elementów w ciągu.
max_size	Zwraca maksymalną liczbę znaków, które mogą zawierać ciąg znaków.
pop_back	Usuwa ostatni element łańcucha.
push_back	Dodaje element do końca ciągu.
rbegin	Zwraca pierwszy element w ciągu wycofanych iterację.
rend	Zwraca iterację tego punktów tuż za ostatnim elementem w ciągu wycofana.
Zamień	Zastępuje elementy w ciągu w określonym miejscu określonych znaków lub skopiowane z innych zakresów lub ciągów znaków lub c ciągi znaków.
rezerwy	Ustawia zdolności ciągu na liczbę co najmniej równie wysoka jak określonej liczby.
Zmienianie rozmiaru	Określa nowy rozmiar ciągu, dołączania lub wymazywanie elementów, jak jest to wymagane.
rfind	Wyszukuje ciąg w kierunku do tyłu dla pierwszego wystąpienia podciąg, który odpowiada określonej sekwencji znaków.
shrink_to_fit	Odrzuca nadwyżka zdolności produkcyjnej w ciągu.
rozmiar	Zwraca bieżącą liczbę elementów w ciągu.
substr	Kopiuje podciąg najwyżej pewna liczba znaków z ciągu rozpoczynającego się od określonego położenia.
Zamień	Wymiana zawartości dwóch ciągów.

Operatory

operator +=	Dołącza ciąg znaków.
operator =	Przypisuje nowy znak wartości zawartość ciągiem.
operatora]	Zawiera odwołanie do znaku z określonego indeksu w ciągu znaków.

Wymagania

Nagłówek: <string>

Obszar nazw: std

Zobacz też

Informacje

Bezpieczeństwo wątków w standardowa biblioteka języka C++

Inne zasoby

basic_string członkowie

<string> Członkowie

Udostępnij za pośrednictwem