std::experimental:: basic_string_view

Fusionné dans la norme ISO C++ La fonctionnalité décrite sur cette page a été intégrée dans la norme principale ISO C++ à partir de 03/2016, voir std::basic_string_view (depuis C++17)

Défini dans l'en-tête <experimental/string_view>
template < class CharT, class Traits = std:: char_traits < CharT > > class basic_string_view ;		(library fundamentals TS)

Le modèle de classe basic_string_view décrit un objet qui peut faire référence à une séquence contiguë constante de char -like objects avec le premier élément de la séquence à la position zéro.

Une implémentation typique ne contient que deux membres : un pointeur vers une constante CharT et une taille.

Plusieurs typedefs pour les types de caractères courants sont fournis :

Défini dans l'en-tête <experimental/string_view>
Type	Définition
std::experimental::string_view	std :: experimental :: basic_string_view < char >
std::experimental::wstring_view	std :: experimental :: basic_string_view < wchar_t >
std::experimental::u16string_view	std :: experimental :: basic_string_view < char16_t >
std::experimental::u32string_view	std :: experimental :: basic_string_view < char32_t >

Table des matières 1 Paramètres du template 2 Types membres 3 Fonctions membres 3.1 Itérateurs 3.2 Accès aux éléments 3.3 Capacité 3.4 Modificateurs 3.5 Opérations 4 Constantes 5 Fonctions non-membres 5.1 Entrée/sortie 6 Classes auxiliaires 7 Macros de test de fonctionnalité

Paramètres du modèle

CharT	-	type de caractère
Traits	-	classe de traits spécifiant les opérations sur le type de caractère

Types membres

Type de membre	Définition
traits_type	Traits
value_type	CharT
pointer	CharT*
const_pointer	const CharT*
reference	CharT&
const_reference	const CharT&
const_iterator	défini par l'implémentation LegacyRandomAccessIterator
iterator	const_iterator
reverse_iterator	const_reverse_iterator
const_reverse_iterator	std:: reverse_iterator < const_iterator >
size_type	std::size_t
difference_type	std::ptrdiff_t

Note : iterator et const_iterator sont le même type car les string views sont des vues sur des séquences de caractères constantes.

Fonctions membres

(constructor)	construit un basic_string_view (fonction membre publique)
operator=	assigne une vue (fonction membre publique)
Itérateurs
begin cbegin	retourne un itérateur vers le début (fonction membre publique)
end cend	retourne un itérateur vers la fin (fonction membre publique)
rbegin crbegin	retourne un itérateur inverse vers le début (fonction membre publique)
rend crend	retourne un itérateur inverse vers la fin (fonction membre publique)
Accès aux éléments
operator[]	accéder au caractère spécifié (fonction membre publique)
at	accéder au caractère spécifié avec vérification des limites (fonction membre publique)
front	accède au premier caractère (fonction membre publique)
back	accède au dernier caractère (fonction membre publique)
data	renvoie un pointeur vers le premier caractère d'une vue (fonction membre publique)
Capacité
size length	retourne le nombre de caractères (fonction membre publique)
max_size	retourne le nombre maximum de caractères (fonction membre publique)
empty	vérifie si la vue est vide (fonction membre publique)
Modificateurs
remove_prefix	réduit la vue en déplaçant son début vers l'avant (fonction membre publique)
remove_suffix	réduit la vue en déplaçant sa fin vers l'arrière (fonction membre publique)
swap	échange le contenu (fonction membre publique)
Opérations
to_string operator basic_string	crée une chaîne à partir de la vue (fonction membre publique)
copy	copie des caractères (fonction membre publique)
substr	retourne une sous-chaîne (fonction membre publique)
compare	compare deux vues (fonction membre publique)
find	rechercher des caractères dans la vue (fonction membre publique)
rfind	trouver la dernière occurrence d'une sous-chaîne (fonction membre publique)
find_first_of	trouver la première occurrence de caractères (fonction membre publique)
find_last_of	trouver la dernière occurrence de caractères (fonction membre publique)
find_first_not_of	trouver la première absence de caractères (fonction membre publique)
find_last_not_of	trouver la dernière absence de caractères (fonction membre publique)
Constantes
npos [static]	valeur spéciale. La signification exacte dépend du contexte (constante de membre public static)

Fonctions non membres

operator== operator!= operator< operator> operator<= operator>=	compare lexicographiquement deux vues (modèle de fonction)
Entrée/sortie
operator<<	effectue une sortie de flux sur les vues (modèle de fonction)

Classes d'assistance

std::hash <std::experimental::string_view> std::hash <std::experimental::wstring_view> std::hash <std::experimental::u16string_view> std::hash <std::experimental::u32string_view>

prise en charge du hachage pour les vues (spécialisation de modèle de classe)

Macros de test de fonctionnalités

__cpp_lib_experimental_string_view

une valeur d'au moins 201411 indique que le modèle basic_string_view est pris en charge (constante macro)