basic_string – třída

Pořadí řídí aktualizaci objektu třídy šablony basic_string třída string Standard C++ a jsou obvykle pokládány za řetězce, ale by neměl být zaměněny s řetězci stylu jazyka C ukončený hodnotou null, který se používá v celém standardní knihovny C++.Standard C++ řetězec je kontejner, který umožňuje použití řetězce jako normální typy, jako je například operace porovnání a zřetězení, iterátory, algoritmů STL a kopírování a přiřazení s přidělení třídy spravované paměti.Pokud potřebujete Standard C++ řetězec převést na řetězec ve stylu C ukončený hodnotou null, použijte basic_string::c_str člena.

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

Parametry

• CharType
  Datový typ jednoho znaku, který má být uložen v řetězci.Standardní knihovny C++ poskytuje odborností této šablony třídy s definice typu řetězec pro elementy typu char, wstring, pro wchar_t, u16string pro char16_t, a u32string pro char32_t.

• Traits
  Různé důležité vlastnosti CharType elementů v basic_string dosažené jsou popsány třídou vlastnostmi.Výchozí hodnota je char_traits<CharType>.

• Allocator
  Typ, který představuje uložené přidělení objekt, který zapouzdřuje informace o přidělení a odebrané paměti na řetězec.Výchozí hodnota je přidělení<CharType>.

Konstruktory

basic_string

Vytvoří řetězec, který je prázdný nebo inicializovaného zvláštní znaky nebo který je kopie všech nebo část druhý objekt řetězec nebo řetězec C.

Typedefs

allocator_type	Typ, který představuje allocator třídu pro objekt řetězce.
const_iterator	Typ, který poskytuje náhodný přístup iterační, který může získat přístup k a číst const element v řetězci.
const_pointer	Typ, který poskytuje ukazatel const element v řetězci.
const_reference	Typ, který poskytuje odkaz const element uložené v řetězci pro čtení a provádění const operace.
const_reverse_iterator	Typ, který poskytuje náhodný přístup iterační, která mohou číst libovolný const element v řetězci.
difference_type	Typ, který poskytuje rozdíl mezi dvěma iterátory, které odkazují na elementů v rámci stejného řetězce.
iterátor	Typ, který poskytuje iterační náhodný přístup, který může číst nebo upravovat libovolný element v řetězci.
npos	Nepodepsané celočíselnou hodnotu inicializována tak, aby -1, která určuje buď "nebyl nalezen." nebo "všechny zbývající znaky" Pokud se nezdaří vyhledávací funkce.
ukazatel	Typ, který poskytuje odkaz na element znak v poli řetězec nebo znak.
reference	Typ, který poskytuje odkaz na element uložené v řetězci.
reverse_iterator	Typ, který poskytuje iterační náhodný přístup, který může číst nebo upravovat elementu v reverzních řetězec.
size_type	Nepodepsané integrální typ. pro počet prvků v řetězci.
traits_type	Typ pro znaky znakové elementů uložené v řetězci.
value_type	Typ, který představuje typ znaků, které jsou uloženy v řetězci.

Členské funkce

připojit	Přidá na konec řetězce znaků.
přiřazení	Přiřadí nový znak hodnoty obsah řetězce.
na	Vrátí odkaz na element v zadaném umístění v řetězci.
zpět
begin	Vrátí iterace adresování prvním elementem v řetězci.
c_str	Převede řetězec obsah jako řetězec ve stylu jazyka C ukončený hodnotou null.
kapacita	Vrátí největší počet elementů, které by mohl být uložen v řetězci bez zvýšení přidělení paměti řetězce.
cbegin	Vrátí argument iterační adresování prvním elementem v řetězci.
cend	Vrátí argument iterační, které se specializuje umístění následných posledním prvkem v řetězci.
vymazat	Vymaže všechny elementy řetězce.
compare	Porovná řetězec s zadaný řetězec k určení, zda jsou dva řetězce stejné, nebo pokud je lexicographically menší než druhé.
copy	Zkopíruje maximálně zadaný počet znaků z indexované místa v řetězci zdroje do cílového pole znaků.ZastaraléPoužití basic_string::_Copy_s místo.
crbegin	Vrátí argument iterační, které se specializuje prvním elementem v reverzních řetězec.
crend	Vrátí argument iterační, které se specializuje na umístění následných posledním prvkem v reverzních řetězec.
_Copy_s	Zkopíruje maximálně zadaný počet znaků z indexované místa v řetězci zdroje do cílového pole znaků.
data	Převede obsah řetězce na pole znaků.
empty	Ověřuje, zda řetězec obsahuje znaky.
end	Vrátí iterace řešící umístění následných posledním prvkem v řetězci.
smazat	Odebere element nebo rozsahu prvků v řetězci ze zadaného umístění.
find	Vyhledá řetězec ve směru vpřed pro první výskyt podřetězci, který odpovídá zadanému pořadí znaků.
find_first_not_of	Hledá v řetězci prvního znaku, který není libovolný element zadaný řetězec.
find_first_of	Hledá v řetězci prvního znaku, který odpovídá libovolný element zadaný řetězec.
find_last_not_of	Hledá v řetězec jeho poslední znak, který není libovolný element zadaný řetězec.
find_last_of	Hledá v řetězec poslední znak, který je element zadaného řetězce.
popředí	Vrátí odkaz na prvním elementem v řetězci.
get_allocator	Vrátí kopii allocator objekt použitý k vytvoření řetězec.
insert	Vloží prvek nebo počet elementů nebo rozsahu prvků do řetězce na zadané pozici.
length	Vrátí aktuální počet prvků v řetězci.
max_size	Vrací maximální počet znaků, které by mohly obsahovat řetězec.
pop_back	Vymaže posledním elementem řetězce.
push_back	Přidá element na konec řetězce.
rbegin	Vrátí iterace prvním elementem v reverzních řetězec.
rend	Vrátí iterace odkazující bezprostředně za posledním elementem reverzních řetězce.
replace	Nahradí elementy v řetězci na zadané pozici zadané znaky nebo znaky zkopírovaných z jiných rozsahů nebo řetězce nebo C řetězce.
Rezervovat	Nastaví kapacity řetězec na číslo alespoň skvělé jako zadané číslo.
změnit velikost	Určuje novou velikost řetězce, přidávání nebo mazání elementy podle potřeby.
rfind	Vyhledá řetězec ve směru zpětné pro první výskyt podřetězci, který odpovídá zadanému pořadí znaků.
shrink_to_fit	Zruší změny přílišné kapacitu řetězce.
velikost	Vrátí aktuální počet prvků v řetězci.
substr	Kopíruje s podřetězcem maximálně některé počet znaků z řetězce začátku ze zadaného umístění.
swap	Výměna obsah dva řetězce.

Operátory

operator+=	Přidá řetězec znaků.
operator=	Přiřadí nový znak hodnoty obsah řetězce.
operátor[]	Poskytuje odkaz na znak, který se zadaným indexem v řetězci.

Poznámky

Pokud je funkce vyzván k vygenerování posloupnost delší než max_size prvků, funkce hlásí chybu délka vyvoláním objektu typu length_error.

Odkazy, ukazatele a iterátory, které označíte elementy řízené sekvenci může se stát neplatným po jakékoli volání funkce, která mění řízené sekvenci nebo po prvním volání jinou hodnotu nežkonstantní členské funkce.

Požadavky

Záhlaví: < řetězec >

Obor názvů: std

Viz také

Referenční dokumentace

<string>

Bezpečný přístup z více vláken ve standardní knihovně C++