basic_string Class

Articolo
03/15/2013

Le sequenze controllate da un oggetto del modello classe basic_string sono la classe string Standard di C++ e vengono in genere definite come stringhe, ma non deve essere confusi con la terminazione null C-stringhe utilizzate in tutta la libreria Standard di C++.La classe string è un contenitore che consente l'utilizzo di stringhe come tipi normali, ad esempio mediante le operazioni di confronto e di concatenazione, iteratori e gli algoritmi STL e la copia e assegnazione di allocatore di classe di memoria gestita.

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

Parametri

CharType
Il tipo di dati di un singolo carattere da memorizzare nella stringa.La libreria Standard di C++ fornisce due specializzazioni di questa classe di modello, con le definizioni dei tipi stringa, per gli elementi di tipo char, e wstring, per gli elementi di tipo wchar_t.
Traits
Diverse proprietà importanti del CharType sono descritti gli elementi in una specializzazione basic_string dalla classe Traits.
Allocator
Il tipo che rappresenta l'oggetto allocatore stored che incapsula i dettagli sull'allocazione e deallocazione della memoria la stringa.Il valore predefinito è allocatore*<Type>.*

Molte funzioni membro richiedono una sequenza di operando di elementi.È possibile specificare quali una sequenza di operando diversi modi.

Elemento	Descrizione
_Ch	Un elemento con valore di carattere _Ch.
_Count, _Ch	Ripetizione della _Count elementi con valore _Ch.
_Ptr	Una sequenza di terminazione null, ad esempio una stringa C, con un CharType di tipo char, partire dal _Ptr (che non deve essere un puntatore null), dove l'elemento di terminazione è il valore value_type e non fa parte della sequenza operando.
_Ptr, _Count	Una sequenza di _Count elementi a partire dal _Ptr.
_Str	La sequenza specificata da un oggetto basic_string.
_Str, _Off, _Count	La sottostringa dell'oggetto basic_string _Str con fino a _Count gli elementi (o fino alla fine della stringa, a seconda di quale è la prima) a partire dalla posizione _Off.
_First, _Last	Una sequenza di elementi delimitati dagli iteratori _First e _Last, nell'intervallo [_First, _Last), che possono sovrapporsi la sequenza controllata dall'oggetto stringa viene richiamata la cui funzione membro.

Se un argomento di posizione (ad esempio _Off) va oltre la fine della stringa in una chiamata a un basic_string funzione membro, la funzione segnalerà un errore all'intervallo mediante la generazione di un oggetto di tipo out_of_range classe.

Se una funzione viene richiesto di generare una sequenza più di max_size gli elementi, la funzione segnala un errore di lunghezza generando un oggetto di tipo length_error classe.

I riferimenti, i puntatori e iteratori designare gli elementi della sequenza controllato possono diventare non validi dopo una chiamata a una funzione che altera la sequenza controllata o dopo la prima chiamata a un non-const una funzione membro.

Costruttori

basic_string

Costruisce una stringa vuota o inizializzato con caratteri specifici o è una copia di tutti o parte di un altro oggetto string o stringa di C.

Definizioni typedef

allocator_type	Un tipo che rappresenta il allocator classe per un oggetto string.
const_iterator	Un tipo che fornisce un iteratore ad accesso casuale che è in grado di accedere e leggere un const elemento della stringa.
const_pointer	Un tipo che fornisce un puntatore a un const elemento in una stringa.
const_reference	Un tipo che fornisce un riferimento a un const elemento memorizzato in una stringa per la lettura e l'esecuzione di const le operazioni.
const_reverse_iterator	Un tipo che fornisce un iteratore di accesso casuale che possono leggere qualsiasi const elemento della stringa.
difference_type	Un tipo che fornisce la differenza tra due iteratori che fanno riferimento a elementi all'interno della stringa stessa.
iteratore	Un tipo che fornisce un iteratore ad accesso casuale in grado di leggere o modificare qualsiasi elemento in una stringa.
nPos	Un valore integrale senza segno inizializzato su – 1 che indica uno "non trovato" o "tutti i caratteri rimanenti" quando una funzione di ricerca ha esito negativo.
pointer	Un tipo che fornisce un puntatore a un elemento di carattere in una matrice di stringa o un carattere.
Riferimento	Un tipo che fornisce un riferimento a un elemento in una stringa.
reverse_iterator	Un tipo che fornisce un iteratore ad accesso casuale in grado di leggere o modificare un elemento in una stringa stornata.
size_type	Un tipo integrale senza segno per il numero di elementi in una stringa.
traits_type	Un tipo per le caratteristiche del carattere degli elementi archiviati in una stringa.
value_type	Un tipo che rappresenta il tipo di caratteri in una stringa.

Funzioni membro

append	Aggiunge alla fine di una stringa di caratteri.
assign	Consente di assegnare nuovi valori di carattere per il contenuto di una stringa.
at	Restituisce un riferimento all'elemento in una posizione specificata nella stringa.
back
begin	Restituisce un iteratore di indirizzamento del primo elemento della stringa.
c_str	Converte il contenuto di una stringa come una stringa con terminazione null di tipo C.
capacity	Restituisce il numero massimo di elementi che possono essere archiviati in una stringa senza aumentare l'allocazione di memoria della stringa.
cbegin	Restituisce un iteratore const indirizzamento del primo elemento della stringa.
cend	Restituisce un iteratore const che risolve il percorso che seguono l'ultimo elemento in una stringa.
clear	Cancella tutti gli elementi di una stringa.
compare	Confronta una stringa con una stringa specificata per determinare se due stringhe sono uguali o se ne è a livello lessicografico minore rispetto a altro.
copy	Copia al massimo un numero specificato di caratteri da una posizione indicizzata in una stringa di origine in una matrice di caratteri di destinazione.Deprecata.In alternativa, utilizzare basic_string::_Copy_s.
crbegin	Restituisce un iteratore const che risolve il primo elemento in una stringa stornata.
crend	Restituisce un iteratore const che risolve il percorso che seguono l'ultimo elemento in una stringa stornata.
_Copy_s	Copia al massimo un numero specificato di caratteri da una posizione indicizzata in una stringa di origine in una matrice di caratteri di destinazione.
data	Converte il contenuto di una stringa in una matrice di caratteri.
empty	Verifica se la stringa contiene caratteri.
end	Restituisce un iteratore che risolve il percorso che seguono l'ultimo elemento in una stringa.
Cancella (Erase)	Rimuove un elemento o un intervallo di elementi in una stringa da una posizione specificata.
find	Cerca una stringa in una direzione di marcia per la prima occorrenza di una sottostringa che corrisponde a una sequenza di caratteri specificata.
find_first_not_of	Ricerca tramite una stringa del primo carattere che non è un elemento di una stringa specificata.
find_first_of	Ricerche tramite una stringa per il primo carattere che corrisponde a qualsiasi elemento di una stringa specificata.
find_last_not_of	Ricerche tramite una stringa per l'ultimo carattere non è un elemento di una stringa specificata.
find_last_of	Ricerche tramite una stringa per l'ultimo carattere è un elemento di una stringa specificata.
front	Restituisce un riferimento al primo elemento in una stringa.
get_allocator	Restituisce una copia del allocator oggetto utilizzato per costruire la stringa.
Inserisci	Inserisce un elemento o un numero di elementi o un intervallo di elementi nella stringa in una posizione specificata.
length	Restituisce il numero corrente di elementi di una stringa.
max_size	Restituisce il numero massimo di caratteri che potrebbe contenere una stringa.
pop_back	Cancella l'ultimo elemento della stringa.
push_back	Aggiunge un elemento alla fine della stringa.
rbegin	Restituisce un iteratore per il primo elemento in una stringa stornata.
rend	Restituisce un iteratore che punta di là dell'ultimo elemento in una stringa stornata.
replace	Sostituisce gli elementi in una stringa in una posizione specificata con caratteri copiati da altri intervalli di stringhe o stringhe di c o di caratteri specificati.
reserve	Imposta la capacità della stringa in un numero almeno equivalente a un numero specificato.
resize	Specifica una nuova dimensione per una stringa, aggiunta o cancellazione di elementi come richiesto.
rfind	Cerca una stringa in una direzione con le versioni precedenti per la prima occorrenza di una sottostringa che corrisponde a una sequenza di caratteri specificata.
shrink_to_fit	Elimina l'eccesso di capacità della stringa.
size	Restituisce il numero corrente di elementi di una stringa.
substr	Copia una sottostringa di al massimo un numero di caratteri da una stringa a partire da una posizione specificata.
scambio	Il contenuto di due stringhe di Exchange.

Operatori

+ = operatore	Aggiunge una stringa di caratteri.
operator=	Consente di assegnare nuovi valori di carattere per il contenuto di una stringa.
operator[]	Fornisce un riferimento al carattere con un indice specificato in una stringa.

Requisiti

Intestazione: <string>

Spazio dei nomi: std

Vedere anche

Riferimenti

Thread safety della libreria C++ standard

Altre risorse

membri basic_string

<stringa> membri

Condividi tramite