std::basic_stringbuf<CharT,Traits,Allocator>:: view
|
std::
basic_string_view
<
CharT, Traits
>
view
(
)
const
noexcept
;
|
(depuis C++20) | |
Crée et retourne un std::basic_string_view sur la séquence de caractères sous-jacente.
- Pour les flux en entrée uniquement, la vue retournée représente l'intervalle [ eback ( ) , egptr ( ) ) .
- Pour les flux en entrée/sortie ou sortie uniquement, référence les caractères depuis pbase ( ) jusqu'au dernier caractère de la séquence, indépendamment de egptr ( ) et epptr ( ) .
- Si le flux n'est ni en entrée ni en sortie, retourne std:: basic_string_view < CharT, Traits > { } .
La séquence de caractères membres dans un tampon ouvert en écriture peut être sur-allouée à des fins d'efficacité. Dans ce cas, seuls les
caractères initialisés
sont référencés : ces caractères sont ceux qui ont été obtenus à partir de l'argument chaîne du constructeur, de l'argument chaîne utilisé par l'appel le plus récent à une surcharge de setter de
str()
, ou d'une opération d'écriture. Une implémentation typique qui utilise la sur-allocation maintient un pointeur de niveau haut pour suivre la fin de la partie initialisée du tampon et la vue retournée référence les caractères de
pbase
(
)
au pointeur de niveau haut.
Table des matières |
Paramètres
(aucun)
Valeur de retour
Une vue sur la séquence de caractères sous-jacente.
Notes
L'utilisation de la valeur de retour est un comportement indéfini si la séquence de caractères sous-jacente est détruite ou invalidée, sauf si la valeur de retour est vide.
Cette fonction est généralement accessible via std::basic_istringstream::view() , std::basic_ostringstream::view() , ou std::basic_stringstream::view() .
Voir aussi
|
remplace ou obtient une copie de la chaîne de caractères associée
(fonction membre publique) |
|
|
(C++17)
|
retourne un
basic_string_view
non modifiable sur la chaîne entière
(fonction membre publique de
std::basic_string<CharT,Traits,Allocator>
)
|