basic_string Class

Sekvence řízena objekt třídy basic_string šablony jsou třída string Standard C++ a obvykle označuje jako řetězce, ale je třeba s zakončený C-řetězce používané v celém Standard C++ Library.Třída string je kontejner, který umožňuje použití řetězce jako běžné typy, například pomocí operace porovnání a zřetězení, u iterátorů a STL algoritmy a kopírování a přiřazení s třídy přidělování spravované paměti.

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

Parametry

• CharType
  Typ dat jeden znak uložen v řetězci.Standard C++ Library obsahuje dvě specializace této šablony třídy, definice typu s řetězec, pro prvky typu char, a wstring, pro prvky typu wchar_t.

• Traits
  Různé důležité vlastnosti CharType třídy jsou popsány prvky specializace basic_string znaky.

• Allocator
  Typ objektu uložených přidělování, které zapouzdřuje podrobnosti o přidělování a navracení zpět paměti řetězec.Výchozí hodnota je přidělování*<Type>.*

Mnoho funkcí členů vyžadují sekvenci operand prvků.Můžete určit takové operand sekvenci několika způsoby.

Element	Description
_Ch	Jeden element s hodnotu znaku _Ch.
_Count, _Ch	Opakování _Count prvky s hodnotou _Ch.
_Ptr	Sekvence zakončený hodnotou null, například c řetězec s CharType typu char, počáteční na _Ptr (který nesmí být ukazatel s hodnotou null), kde ukončující prvek je hodnota value_type a není součástí posloupnosti operand.
_Ptr _Count	Sekvence _Count prvky začínající na _Ptr.
_Str	Řada určený objekt basic_string.
_Str, _Off, _Count	Podřetězec objektu basic_string _Str s až _Count prvky (nebo na konci řetězce proběhne) začíná na pozici _Off.
_First _Last	Pořadí prvků, které jsou odděleny u iterátorů _First a _Last, v rozsahu [_First, _Last), který může překrývat sekvence řízena nazývá jehož členské funkce objektu řetězec.

Pokud argument umístění (například _Off) je za koncem řetězce pro volání na basic_string členské funkce funkce hlásí chybu mimo rozsah o vyvolání objektu typu out_of_range třídy.

Pokud je funkce dotaz Generovat posloupnost delší než max_size prvky, funkce hlásí chybu délku o vyvolání objektu typu length_error třídy.

Odkazy, ukazatele a u iterátorů, které určí prvky řízené sekvence může být neplatná po jakékoliv volání funkce, který mění řízené sekvence nebo než první volání-b členské funkce.

Konstruktory

basic_string

Řetězec, který je prázdný nebo inicializovat určité znaky nebo je kopie všech nebo části jiného objektu se řetězec nebo řetězec c konstrukce.

Funkce TypeDef

allocator_type	Typ, který představuje allocator třídy objektu řetězec.
const_iterator	Typu poskytující iterační random access lze zobrazit a číst const prvku v řetězci.
const_pointer	Typ, který obsahuje ukazatel na const prvku v řetězci.
const_reference	Typ, který poskytuje odkaz na const prvku uložené v řetězci pro čtení a provádění const operací.
const_reverse_iterator	Typ, který poskytuje iterační náhodný přístup, která mohou číst všechny const prvku v řetězci.
difference_type	Typ, který poskytuje rozdíl mezi dvěma u iterátorů, které odkazují na stejný řetězec prvky.
iterace	Typ, který poskytuje iterační náhodný přístup, který lze číst nebo upravovat libovolný prvek v řetězci.
npos	Nepodepsaný integrální hodnota, inicializovat –1, který označuje buď "nebyl nalezen" nebo "všechny zbývající znaky" při selhání funkce Hledat.
ukazatel	Typ, který obsahuje ukazatel na prvek znaku v poli znak nebo řetězec.
odkaz	Typ, který poskytuje odkaz na prvek uložené v řetězci.
reverse_iterator	Typ poskytující iterační random access mohou číst nebo upravovat prvek stornované řetězce.
size_type	Nepodepsaný integrálního typu počet prvků v řetězci.
traits_type	Typ prvky uložené v řetězec o znaky znakem.
value_type	Typ, který představuje typ řetězec znaků.

Funkce členů

připojit	Přidá na konec řetězce znaků.
přiřadit	Obsah řetězce přiřadí nové hodnoty znaků.
na	Vrátí odkaz na prvek v zadaném umístění v řetězci.
zpět
začít	Vrátí první prvek řetězce adresování iterace.
c_str	Převede řetězec jako řetězec zakončený hodnotou null, C-styl.
kapacita	Vrátí největší počet prvků, které může být uložený v řetězci bez zvýšení přidělení paměti řetězce.
cbegin	Vrátí const iterační adresování první prvek řetězce.
cend	Vrátí iterační const, který řeší umístění následných poslední prvek v řetězci.
Vymazat	Vymaže všechny prvky řetězec.
Porovnat	Porovná řetězec zadaný řetězec k určení, pokud jsou dva řetězce stejné nebo je lexicographically méně než ostatní.
Kopírovat	Zkopíruje nejvíce zadaný počet znaků z indexovaných umístění v řetězci zdroje do cílové pole znaků.Nepoužívá.Jako náhradu použijte basic_string::_Copy_s.
crbegin	Vrátí iterační const, který řeší první prvek řetězce převrácené.
crend	Vrátí iterační const, řešící následných poslední prvek v obrácené řetězec umístění.
_Copy_s	Zkopíruje nejvíce zadaný počet znaků z indexovaných umístění v řetězci zdroje do cílové pole znaků.
data	Převede řetězec do pole znaků.
prázdné	Ověřuje, zda řetězec obsahuje znaky.
Konec	Vrátí iterace, který řeší umístění následných poslední prvek v řetězci.
Vymazat	Odstraní prvek nebo prvky rozsah řetězce od zadané pozice.
Najít	Vyhledá řetězec dopředu pro první výskyt podřetězce, který odpovídá zadané posloupnosti znaků.
find_first_not_of	Hledá řetězec první znak, který není libovolný prvek zadaný řetězec.
find_first_of	Hledá řetězec prvního znaku, který odpovídá libovolný prvek zadaný řetězec.
find_last_not_of	Hledá řetězec poslední znak, který není libovolný prvek zadaný řetězec.
find_last_of	Hledá řetězec poslední znak, který je prvek zadaný řetězec.
přední	Vrátí odkaz na první prvek řetězce.
get_allocator	Vrátí kopii allocator objekt použitý k vytvoření řetězce.
Vložit	Vloží prvek nebo prvky nebo rozsah prvků do řetězce na určené pozici.
Délka	Vrátí aktuální počet prvků v řetězci.
max_size	Vrátí maximální počet znaků, které by mohly obsahovat řetězec.
pop_back	Vymaže poslední prvek řetězce.
push_back	Přidá prvek na konci řetězce.
rbegin	Vrátí první prvek řetězce stornované iterace.
rend	Vrátí iterace že body za poslední prvek stornované řetězce.
nahradit	Zadané znaky nebo znaky zkopírovat z jiných oblastí nebo řetězce nebo řetězců c nahradí prvky v řetězci na určené pozici.
rezervovat	Nastaví kapacity řetězce na číslo skvělý jako zadaného čísla.
změnit velikost	Určuje novou velikost řetězce připojení nebo mazání požadované prvky.
rfind	Vyhledá řetězec zpětně směrem první výskyt podřetězce, který odpovídá zadané posloupnosti znaků.
shrink_to_fit	Odstraní nadbytečné kapacity řetězec.
size	Vrátí aktuální počet prvků v řetězci.
SUBSTR	Zkopíruje podřetězec nejvíce některé počet znaků od začátku řetězce od zadané pozice.
Zaměnit	Výměny obsahu dvou řetězců.

Operátory

operátor +=	Připojí řetězec znaků.
operátor =	Obsah řetězce přiřadí nové hodnoty znaků.
operátor]	Poskytuje odkaz na znaku zadaného indexu v řetězci.

Požadavky

Záhlaví: <string>

Obor názvů: std

Viz také

Referenční dokumentace

Bezpečnostní vlákno v Standardní knihovna C++

Další zdroje

basic_string členů

<string> Členové