std:: basic_stringbuf
|
Défini dans l'en-tête
<sstream>
|
||
|
template
<
class
CharT,
|
||
std::basic_stringbuf
est un
std::basic_streambuf
dont la séquence de caractères associée est une séquence résidant en mémoire de caractères arbitraires, qui peut être initialisée à partir ou rendue disponible en tant qu'instance de
std::basic_string
.
Les implémentations typiques de
std::basic_stringbuf
contiennent un objet de type
std::basic_string
ou un conteneur de séquence redimensionnable équivalent directement comme membre de données et l'utilisent à la fois comme séquence de caractères contrôlée (le tableau vers lequel pointent les six pointeurs de
std::basic_streambuf
) et comme séquence de caractères associée (la source de caractères pour toutes les opérations d'entrée et la cible pour la sortie).
De plus, une implémentation typique contient un membre de données de type std::ios_base::openmode pour indiquer le mode d'E/S du flux associé (entrée uniquement, sortie uniquement, entrée/sortie, à la fin, etc.).
|
Si la stratégie de sur-allocation est utilisée par overflow() , un pointeur supplémentaire de niveau haut peut être stocké pour suivre le dernier caractère initialisé. |
(since C++11) |
Plusieurs typedefs pour les types de caractères courants sont fournis :
|
Défini dans l'en-tête
<sstream>
|
|
| Type | Définition |
std::stringbuf
|
std :: basic_stringbuf < char > |
std::wstringbuf
|
std :: basic_stringbuf < wchar_t > |
Table des matières |
Types membres
| Type de membre | Définition |
char_type
|
CharT
|
traits_type
|
Traits
; le programme est mal formé si
Traits::char_type
n'est pas
CharT
.
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
allocator_type
|
Allocator
|
Membres d'exposition uniquement
buf
|
le
std::
basic_string
<
CharT, Traits, Allocator
>
utilisé comme tampon sous-jacent
( objet membre d'exposition uniquement* ) |
mode
|
le
std::ios_base::openmode
du flux associé
( objet membre d'exposition uniquement* ) |
|
initialise les séquences d'entrée et de sortie
( fonction membre d'exposition uniquement* ) |
Fonctions membres publiques
construit un objet
basic_stringbuf
(fonction membre publique) |
|
|
(C++11)
|
assigne un objet
basic_stringbuf
(fonction membre publique) |
|
(C++11)
|
échange deux objets
basic_stringbuf
(fonction membre publique) |
|
(destructor)
[virtual]
(implicitly declared)
|
détruit un objet
basic_stringbuf
et la chaîne qu'il contient
(fonction membre publique virtuelle) |
|
remplace ou obtient une copie de la chaîne de caractères associée
(fonction membre publique) |
|
|
(C++20)
|
obtient une copie de l'allocateur associé au conteneur de séquence interne
(fonction membre publique) |
|
(C++20)
|
obtient une vue sur la séquence de caractères sous-jacente
(fonction membre publique) |
Fonctions membres protégées
|
[virtual]
|
renvoie le caractère suivant disponible dans la séquence d'entrée
(fonction membre protégée virtuelle) |
|
[virtual]
|
replace un caractère dans la séquence d'entrée
(fonction membre protégée virtuelle) |
|
[virtual]
|
ajoute un caractère à la séquence de sortie
(fonction membre protégée virtuelle) |
|
[virtual]
|
tente de remplacer la séquence de caractères contrôlée par un tableau
(fonction membre protégée virtuelle) |
|
[virtual]
|
repositionne le pointeur suivant dans la séquence d'entrée, la séquence de sortie, ou les deux, en utilisant l'adressage relatif
(fonction membre protégée virtuelle) |
|
[virtual]
|
repositionne le pointeur suivant dans la séquence d'entrée, la séquence de sortie, ou les deux en utilisant l'adressage absolu
(fonction membre protégée virtuelle) |
Fonctions non membres
|
(C++11)
|
spécialise l'algorithme
std::swap
(modèle de fonction) |
Hérité de std:: basic_streambuf
Types membres
| Type de membre | Définition |
char_type
|
CharT
|
traits_type
|
Traits
; le programme est mal formé si
Traits::char_type
n'est pas
CharT
.
|
int_type
|
Traits::int_type
|
pos_type
|
Traits::pos_type
|
off_type
|
Traits::off_type
|
Fonctions membres
|
[virtuel]
|
détruit l'objet
basic_streambuf
(fonction membre publique virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
Locales |
|
|
modifie la locale associée et invoque
imbue
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
obtient une copie de la locale associée
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
Positionnement |
|
|
invoque
setbuf
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoque
seekoff
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoque
seekpos
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoque
sync
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
Zone de lecture |
|
|
obtient le nombre de caractères immédiatement disponibles dans la zone de lecture
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
avance la séquence d'entrée, puis lit un caractère sans avancer à nouveau
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
(supprimé en C++17)
|
lit un caractère de la séquence d'entrée et avance la séquence
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
lit un caractère de la séquence d'entrée sans avancer la séquence
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoque
xsgetn
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
Zone d'écriture |
|
|
écrit un caractère dans la zone d'écriture et avance le pointeur suivant
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
invoque
xsputn
(
)
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
Remise |
|
|
remet un caractère dans la séquence d'entrée
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
|
recule le pointeur suivant dans la séquence d'entrée d'une position
(fonction membre publique de
std::basic_streambuf<CharT,Traits>
)
|
|
Fonctions membres protégées
construit un objet
basic_streambuf
(fonction membre protégée) |
|
|
(C++11)
|
remplace un objet
basic_streambuf
(fonction membre protégée) |
|
(C++11)
|
échange deux
basic_streambuf
objects
(fonction membre protégée) |
Locales |
|
|
[virtual]
|
réagit à un changement de la locale associée
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
Positionnement |
|
|
[virtual]
|
remplace le tampon par un tableau défini par l'utilisateur, si autorisé
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
repositionne le pointeur suivant dans la séquence d'entrée, la séquence de sortie, ou les deux, en utilisant l'adressage relatif
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
repositionne le pointeur suivant dans la séquence d'entrée, la séquence de sortie, ou les deux en utilisant l'adressage absolu
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
synchronise les tampons avec la séquence de caractères associée
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
Obtenir la surface |
|
|
[virtual]
|
obtient le nombre de caractères disponibles en entrée dans la séquence d'entrée associée, si connu
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lit les caractères de la séquence d'entrée associée vers la zone de récupération
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lit les caractères de la séquence d'entrée associée vers la zone de récupération et avance le pointeur suivant
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
lit plusieurs caractères de la séquence d'entrée
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
renvoie un pointeur vers le début, le caractère courant et la fin de la zone de lecture
(fonction membre protégée) |
|
|
avance le pointeur suivant dans la séquence d'entrée
(fonction membre protégée) |
|
|
repositionne les pointeurs de début, suivant et de fin de la séquence d'entrée
(fonction membre protégée) |
|
Zone de placement |
|
|
[virtual]
|
écrit plusieurs caractères dans la séquence de sortie
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
[virtual]
|
écrit des caractères dans la séquence de sortie associée depuis la zone de mise en mémoire tampon
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|
|
retourne un pointeur vers le début, le caractère courant et la fin de la zone de mise
(fonction membre protégée) |
|
|
avance le pointeur suivant de la séquence de sortie
(fonction membre protégée) |
|
|
repositionne les pointeurs de début, suivant et fin de la séquence de sortie
(fonction membre protégée) |
|
Putback |
|
|
[virtual]
|
place un caractère dans la séquence d'entrée, en modifiant potentiellement la séquence d'entrée
(fonction membre protégée virtuelle de
std::basic_streambuf<CharT,Traits>
)
|