basic_string — Klasa

Artykuł
06/09/2015

Sekwencje kontrolowane przez obiekt klasy szablonu basic_string klasy string Standard C++ i są zazwyczaj określone jako ciągi, ale nie powinny być różni z C-style zerem ciągów używanych przez cały standardowa biblioteka języka C++.Ciąg Standard C++ jest kontenerem, który umożliwia korzystanie z ciągów jako typy normalny, takie jak operacje porównania i łączenia, Iteratory, algorytmy STL i kopiowanie i przypisywanie za pomocą klasy alokatora zarządzane pamięci.Jeśli trzeba przekonwertować ciąg Standard C++ ciąg C-style zerem, użyj basic_string::c_str elementu członkowskiego.

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

Parametry

CharType
Typ danych, które mają być przechowywane w ciągu jednego znaku.Standardowa biblioteka języka C++ udostępnia specjalizacji tej klasy szablonu z definicjami typu ciąg dla elementów tego typu char, wstring, dla wchar_t, u16string dla char16_t, i u32string dla char32_t.
Traits
Różne właściwości ważne CharType elementów w specjalizacji basic_string są opisane przez klasę cechy.Wartość domyślna to char_traits<CharType>.
Allocator
Typ, który reprezentuje obiekt alokatora przechowywane, który hermetyzuje informacje o alokacji i dezalokacji pamięci ten ciąg.Wartość domyślna to alokatora<CharType>.

Konstruktorów

basic_string

Tworzy ciąg, który jest pusty lub zainicjowanej przez określone znaki lub oznacza to kopii całości lub części innego obiektu ciąg lub C ciągu.

Typedefs

allocator_type	Typ, który reprezentuje allocator klasy dla obiektu ciągu.
const_iterator	Typ, który udostępnia sterująca losowe dostępu, które mogą uzyskać dostęp i odczytać const elementu w ciągu.
const_pointer	Typ, który udostępnia wskaźnik do const elementu w ciągu.
const_reference	Typ, który zawiera odwołanie do const elementu przechowywane w ciągu do odczytu i wykonywania const operacji.
const_reverse_iterator	Typ, udostępniający sterująca losowe dostępu, który może odczytać const elementu w ciągu.
difference_type	Typ, który udostępnia różnicę dwóch Iteratory, które odwołują się do elementów w jeden ciąg.
iterator	Typ, który udostępnia sterująca losowe dostępu, który może odczytywać lub zmodyfikować dowolnego elementu w ciągu.
npos	Wartością całkowitą niepodpisanych zainicjowana w celu -1, która wskazuje pozycję "not found" lub "wszystkie pozostałe znaki" Jeśli funkcja wyszukiwania nie powiodło się.
pointer	Typ, który udostępnia wskaźnik do elementu znaku w ciągu lub znak tablicy.
reference	Typ, który zawiera odwołanie do elementu przechowywane w ciągu.
reverse_iterator	Typ, który udostępnia sterująca losowe dostępu, który może odczytywać lub modyfikowanie elementu w ciągu odwróconej.
size_type	Typu bez znaku zawierającym liczbę całkowitą liczbę elementów w ciągu.
traits_type	Typ dla cechy znak elementów przechowywanych w ciągu.
value_type	Typ, który reprezentuje typ przechowywanych w ciągu znaków.

Funkcje elementów członkowskich

Dołącz	Dodaje znaki do końca ciągu.
Przypisz	Przypisuje nowy wartości znaków zawartość ciągu.
at	Zwraca odwołanie do elementu w określonej lokalizacji w ciągu.
Wstecz
begin	Zwraca iterację opracowywania pierwszym elementem w ciągu.
c_str	Konwertuje wartość ciągu jako ciąg zerem, C-style.
pojemność	Zwraca największą liczbę elementów, które mogą być przechowywane w ciągu bez zwiększania alokacji pamięci ciągu.
cbegin	Zwraca stała sterująca opracowywania pierwszym elementem w ciągu.
cend	Zwraca stała sterująca, zawierające odpowiedzi lokalizacji sukcesy w ciągu ostatniego elementu.
clear	Usuwa wszystkie elementy w ciągu.
compare	Porównuje ciąg zawierający określony ciąg do określenia, czy dwa ciągi są takie same i jeśli zostanie lexicographically mniejszy od drugiego.
copy	Kopiuje co najwyżej określoną liczbę znaków od indeksowanej pozycji w ciągu źródła docelowej tablicy znaków.Przestarzałe.Użyj basic_string::_Copy_s zamiast niego.
crbegin	Zwraca stała sterująca, zawierające odpowiedzi na pierwszym elementem w ciągu odwróconej.
crend	Zwraca stała sterująca, zawierające odpowiedzi lokalizacji sukcesy ostatniego elementu w odwróconej ciąg.
_Copy_s	Kopiuje co najwyżej określoną liczbę znaków od indeksowanej pozycji w ciągu źródła docelowej tablicy znaków.
dane	Konwertuje wartość ciągu na tablicę znaków.
empty	Sprawdza, czy ciąg zawiera znaki.
end	Zwraca iterację, którego dotyczy lokalizacji sukcesy w ciągu ostatniego elementu.
erase	Usuwa element lub zakres elementów w ciągu z określonej pozycji.
find	Wyszukuje ciąg w kierunku do przodu dla pierwszego wystąpienia podciągu zgodnego określonej sekwencji znaków.
find_first_not_of	Wyszukiwanie za pomocą ciągu pierwszego znaku, który nie jest dowolnego elementu określonego ciągu.
find_first_of	Wyszukiwanie za pomocą ciągu pierwszego znaku, który pasuje do dowolnego elementu określonego ciągu.
find_last_not_of	Wyszukiwanie za pomocą ciągu ostatni znak, który nie jest dowolnego elementu określonego ciągu.
find_last_of	Wyszukiwanie za pomocą ciągu ostatni znak, który jest elementem określonego ciągu.
wierzch	Zwraca odwołanie do pierwszym elementem w ciągu.
get_allocator	Zwraca kopię allocator obiekt używany do konstruowania ciąg.
insert	Wstawia element lub wiele elementów lub zakres elementów do ciągu na określonej pozycji.
length	Zwraca bieżącą liczbę elementów w ciągu.
max_size	Zwraca maksymalną liczbę znaków, które mogą zawierać ciąg.
pop_back	Usuwa element ostatnich ciągu.
push_back	Dodaje element do końca ciągu.
rbegin	Zwraca iterację na pierwszym elementem w ciągu odwróconej.
rend	Zwraca iterację tego punkty poza ostatniego elementu w ciągu odwróconej.
replace	Zamienia elementów w ciągu na określonej pozycji określonych znaków lub skopiowanych z innych zakresów lub ciągów lub C ciągi znaków.
rezerwy	Ustawia pojemność ciągu na liczbę co najmniej tak duże, jak określonej liczby.
Zmień rozmiar	Określa nowy rozmiar parametrów, dołączanie lub wymazywanie elementów zgodnie z potrzebami.
rfind	Wyszukuje ciąg w kierunku do tyłu dla pierwszego wystąpienia podciągu zgodnego określonej sekwencji znaków.
shrink_to_fit	Odrzuca nadmiernego pojemność ciągu.
size	Zwraca bieżącą liczbę elementów w ciągu.
substr	Kopiuje podciąg co najwyżej pewną liczbę znaków od początku ciągu z określonej pozycji.
swap	Wymiany zawartość dwóch ciągów.

Operatory

operator+=	Dołącza ciąg znaków.
operator=	Przypisuje nowy wartości znaków zawartość ciągu.
operator[]	Zawiera odwołanie do znaku o określonym indeksie w ciągu.

Uwagi

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

Odwołania, wskaźników i Iteratory, które określają elementy kontrolowanych sekwencji może utracić ważność po dowolnej wywołaniem funkcji zmieniającą kontrolowanych sekwencji lub po pierwszym wywołaniu niżstała funkcji elementu członkowskiego.

Wymagania

Nagłówek: < ciąg >

Przestrzeń nazw: std

Zobacz też

Informacje

Bezpieczeństwo wątku w standardowej bibliotece C++

Udostępnij za pośrednictwem