basic_string Class

Article
03/15/2013

Les séquences contrôlés par un objet de modèle classe basic_string sont la classe de chaîne C++ Standard et sont généralement appelés chaînes, mais ils ne doivent pas être confondus avec les se terminant par null C-chaînes utilisées tout au long de la bibliothèque C++ Standard.La classe string est un conteneur qui permet l'utilisation de chaînes en tant que types normaux, tels que l'utilisation des opérations de comparaison et de concaténation, itérateurs et algorithmes STL et copie et affectation d'allocateur de classe de mémoire gérée.

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

Paramètres

CharType
Le type de données d'un seul caractère pour être stockés dans la chaîne.La bibliothèque C++ Standard fournit deux spécialisations de cette classe de modèle, avec les définitions de type chaîne, pour les éléments de type char, et wstring, pour les éléments de type wchar_t.
Traits
Diverses propriétés importantes de la CharType les éléments dans une spécialisation basic_string sont décrits par la classe Traits.
Allocator
Le type qui représente l'objet allocateur stockée qui encapsule les détails sur l'allocation et la désallocation de mémoire de la chaîne.La valeur par défaut est allocateur*<Type>.*

Nombreuses fonctions membres nécessitent une séquence d'éléments d'opérande.Vous pouvez spécifier ce une séquence d'opérande de plusieurs façons.

Élément	Description
_Ch	Un élément avec la valeur de caractère _Ch.
_Count, _Ch	Une répétition de _Count éléments avec la valeur _Ch.
_Ptr	Une séquence se termine par null, comme une chaîne C, avec une CharType de type char, commence au _Ptr (qui ne doit pas être un pointeur null), où l'élément de fin est la valeur value_type et n'est pas partie de la séquence de l'opérande.
_Ptr, _Count	Une séquence de _Count éléments en commençant à _Ptr.
_Str	La séquence spécifiée par un objet basic_string.
_Str, modem.inf, installez, _Count	La sous-chaîne de l'objet basic_string _Str avec jusqu'à _Count éléments (ou jusqu'à la fin de la chaîne, prévalant) commençant à la position modem.inf, installez.
_First, _Last	Une séquence d'éléments délimitées par les itérateurs _First et _Last, dans la plage [_First, _Last), qui peuvent se chevaucher la séquence contrôlée par l'objet de chaîne dont la fonction membre est appelée.

Si un argument de position (tels que _Off) est au-delà de la fin de la chaîne sur un appel à une basic_string fonction membre, la fonction signale une erreur hors des limites en levant un objet de type out_of_range classe.

Si une fonction est invitée à générer une séquence plus longue que taille_max elements, la fonction signale une erreur de longueur en levant un objet de type length_error classe.

Références, les pointeurs et les itérateurs qui désignent les éléments de la séquence contrôlée peuvent devenir non valides après un appel à une fonction qui modifie la séquence contrôlée ou après le premier appel à un site non-const une fonction membre.

Constructeurs

basic_string

Construit une chaîne est vide ou initialisé par des caractères spécifiques ou qui est une copie de toutes ou partie d'un autre objet de chaîne ou chaîne de C.

Typedef

allocator_type	Un type qui représente le allocator classe pour un objet string.
const_iterator	Un type qui fournit un itérateur d'accès aléatoire qui peut accéder et lire un const élément de la chaîne.
const_pointer	Un type qui fournit un pointeur vers un const élément dans une chaîne.
const_reference	Un type qui fournit une référence à une const élément stocké dans une chaîne de lecture et d'exécution const opérations.
const_reverse_iterator	Un type qui fournit un itérateur d'accès aléatoire pouvant lire les const élément de la chaîne.
difference_type	Un type qui fournit la différence entre deux itérateurs qui font référence aux éléments au sein de la même chaîne.
itérateur	Un type qui fournit un itérateur d'accès aléatoire qui peut lire ou modifier n'importe quel élément dans une chaîne.
nPos	Une valeur non signée intégrale initialisée à – 1 qui indique soit « introuvable » ou « tous les caractères restants » lorsqu'une fonction de recherche échoue.
pointer	Un type qui fournit un pointeur vers un élément de caractère dans un tableau de chaîne ou un caractère.
Référence	Un type qui fournit une référence à un élément stocké dans une chaîne.
reverse_iterator	Un type qui fournit un itérateur d'accès aléatoire qui peut lire ou modifier un élément dans une chaîne inversé.
size_type	Un type intégral non signé pour le nombre d'éléments dans une chaîne.
traits_type	Un type pour les traits de caractère des éléments stockés dans une chaîne.
Value_type	Un type qui représente le type de caractères stockées dans une chaîne.

Fonctions membres

append	Ajoute des caractères à la fin d'une chaîne.
assign	Assigne de nouvelles valeurs de caractère pour le contenu d'une chaîne.
at	Renvoie une référence à l'élément à un emplacement spécifié dans la chaîne.
back
begin	Retourne un itérateur adressage au premier élément dans la chaîne.
c_str	Convertit le contenu d'une chaîne en tant que chaîne terminée par null, C-style.
capacity	Retourne le plus grand nombre d'éléments qui pourraient être stockées dans une chaîne sans augmenter l'allocation de mémoire de la chaîne.
cbegin	Retourne un itérateur const adressage au premier élément dans la chaîne.
cend	Retourne un itérateur const qui répond à l'emplacement suivant le dernier élément dans une chaîne.
clear	Efface tous les éléments d'une chaîne.
compare	Compare une chaîne avec une chaîne spécifiée pour déterminer si les deux chaînes sont égales ou si l'un est lexicographiquement inférieure à l'autre.
copy	Copie au plus un nombre spécifié de caractères à partir d'une position d'index dans une chaîne source dans un tableau de caractères cible.Déconseillé.Utilisez plutôt basic_string::_Copy_s.
crbegin	Retourne un itérateur const qui répond au premier élément dans une chaîne inversé.
crend	Retourne un itérateur const qui répond à l'emplacement suivant le dernier élément dans une chaîne inversé.
_Copy_s	Copie au plus un nombre spécifié de caractères à partir d'une position d'index dans une chaîne source dans un tableau de caractères cible.
data	Convertit le contenu d'une chaîne en un tableau de caractères.
empty	Teste si la chaîne contient des caractères.
end	Retourne un itérateur qui répond à l'emplacement suivant le dernier élément dans une chaîne.
Effacer	Supprime un élément ou une plage d'éléments dans une chaîne à partir d'une position spécifiée.
find	Recherche une chaîne vers l'avant pour la première occurrence d'une sous-chaîne correspondant à une séquence de caractères spécifiée.
find_first_not_of	Effectue une recherche dans une chaîne pour le premier caractère n'est pas n'importe quel élément d'une chaîne spécifiée.
find_first_of	Effectue une recherche dans une chaîne pour le premier caractère correspond à n'importe quel élément d'une chaîne spécifiée.
find_last_not_of	Effectue une recherche dans une chaîne pour le dernier caractère qui n'est pas n'importe quel élément d'une chaîne spécifiée.
find_last_of	Effectue une recherche dans une chaîne pour le dernier caractère est un élément de la chaîne spécifiée.
front	Renvoie une référence au premier élément d'une chaîne.
get_allocator	Retourne une copie de la allocator objet utilisé pour construire la chaîne.
Insérer	Insère un élément ou un nombre d'éléments ou une plage d'éléments dans la chaîne à une position spécifiée.
length	Renvoie le nombre d'éléments dans une chaîne.
max_size	Renvoie le nombre maximal de caractères de qu'une chaîne peut contenir.
pop_back	Efface le dernier élément de la chaîne.
push_back	Ajoute un élément à la fin de la chaîne.
rbegin	Retourne un itérateur vers le premier élément dans une chaîne inversé.
rend	Retourne un itérateur qui pointe juste après le dernier élément dans une chaîne inversée.
replace	Remplace les éléments dans une chaîne à une position spécifiée avec les caractères spécifiés ou copié à partir d'autres plages ou ou des chaînes C.
reserve	Définit la capacité de la chaîne d'un nombre au moins aussi grande que le nombre spécifié.
resize	Spécifie une nouvelle taille pour une chaîne, l'ajout ou d'effacer les éléments requis.
Rfind	Recherche une chaîne dans une direction ascendante pour la première occurrence d'une sous-chaîne correspondant à une séquence de caractères spécifiée.
shrink_to_fit	Ignore la capacité excédentaire de la chaîne.
taille	Renvoie le nombre d'éléments dans une chaîne.
SUBSTR	Copie une sous-chaîne d'au plus un nombre de caractères à partir d'une chaîne commençant à partir d'une position spécifiée.
swap	Le contenu de deux chaînes d'Exchange.

Opérateurs

opérateur +=	Ajoute une chaîne de caractères.
operator=	Assigne de nouvelles valeurs de caractère pour le contenu d'une chaîne.
operator[]	Fournit une référence au caractère avec un index spécifié dans une chaîne.

Configuration requise

En-tête : <string>

Espace de noms : std

Voir aussi

Référence

Sécurité des threads dans la bibliothèque C++ standard

Autres ressources

membres basic_string

<string> membres