strstream, classe

Décrit un objet qui contrôle l’insertion et l’extraction d’éléments et d’objets encodés à l’aide d’une mémoire tampon de flux de classe strstreambuf.

Syntaxe

class strstream : public iostream

Notes

L'objet stocke un objet de classe strstreambuf.

Remarque

Cette classe est déconseillée. Utilisez plutôt stringstream ou wstringstream.

Constructeurs

Constructeur	Description
strstream	Construit un objet de type strstream.

Fonctions Membre

Fonction membre	Description
freeze	Fait en sorte qu'une mémoire tampon de flux soit indisponible via des opérations de mémoire tampon de flux.
pcount	Retourne le nombre d'éléments écrits dans la séquence contrôlée.
rdbuf	Retourne un pointeur vers l'objet strstreambuf associé au flux.
str	Appelle freeze, puis retourne un pointeur vers le début de la séquence contrôlée.

Spécifications

Header :<strstream>

Espace de noms : std

strstream ::freeze

Fait en sorte qu'une mémoire tampon de flux soit indisponible via des opérations de mémoire tampon de flux.

void freeze(bool _Freezeit = true);

Paramètres

_Freezeit
bool indiquant si vous souhaitez que le flux soit gelé.

Notes

La fonction membre appelle rdbuf ->freeze(_ Freezeit).

Exemple

Consultez strstreambuf ::freeze pour obtenir un exemple qui utilise freeze.

strstream ::p count

Retourne le nombre d'éléments écrits dans la séquence contrôlée.

streamsize pcount() const;

Valeur de retour

Nombre d’éléments écrits dans la séquence contrôlée.

Notes

La fonction membre retourne rdbuf ->pcount.

Exemple

Pour obtenir un exemple d’utilisation de pcount, consultez strstreambuf::pcount.

strstream ::rdbuf

Retourne un pointeur vers l’objet strstreambuf associé au flux.

strstreambuf *rdbuf() const

Valeur de retour

Un pointeur vers l’objet strstreambuf associé au flux.

Notes

La fonction membre retourne l’adresse de la mémoire tampon de flux stockée de type pointer à strstreambuf.

Exemple

Pour obtenir un exemple qui utilise rdbuf, consultez strstreambuf::pcount.

strstream ::str

Appelle freeze, puis retourne un pointeur vers le début de la séquence contrôlée.

char *str();

Valeur de retour

Pointeur vers le début de la séquence contrôlée.

Notes

La fonction membre retourne rdbuf ->str.

Exemple

Consultez strstreambuf ::str pour obtenir un exemple qui utilise str.

strstream ::strstream

Construit un objet de type strstream.

strstream();

strstream(char* ptr,
    streamsize count,
    ios_base::openmode _Mode = ios_base::in | ios_base::out);

Paramètres

count
Taille de la mémoire tampon.

_Mode
Mode d’entrée et de sortie de la mémoire tampon. Pour plus d’informations, consultez ios_base::openmode.

ptr
Mémoire tampon.

Notes

Les deux constructeurs initialisent la classe de base en appelant streambuf( sb), où sb est l’objet stocké de la classe strstreambuf. Le premier constructeur initialise également en sb appelant strstreambuf. Le deuxième constructeur initialise la classe de base d’une des deux façons suivantes :

• Si _Mode &ios_base ::app== 0, ptrdoit désigner le premier élément d’un tableau d’éléments count et les appels strstreambufdu constructeur ( , ptrcount, ptr).

• Sinon, ptr doit désigner le premier élément d’un tableau d’éléments de nombre qui contient une chaîne C dont le premier élément est désigné par ptr, et le constructeur appelle strstreambuf( ptr, ptrcount + strlen, ( ptr) ).

Voir aussi

iostream
Sécurité des threads dans la bibliothèque C++ Standard
iostream, programmation
iostreams, conventions