Partager via


basic_string Class

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.

syxtdd4f.collapse_all(fr-fr,VS.110).gifConstructeurs

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.

syxtdd4f.collapse_all(fr-fr,VS.110).gifTypedef

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.

syxtdd4f.collapse_all(fr-fr,VS.110).gifFonctions 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.

syxtdd4f.collapse_all(fr-fr,VS.110).gifOpé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