Partager via

ostrstream, classe

  • Article

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

Syntaxe

class ostrstream : public ostream

Notes

L'objet stocke un objet de classe strstreambuf.

Remarque

Cette classe est déconseillée. Utilisez plutôt ostringstream ou wostringstream.

Constructeurs

Constructeur Description
ostrstream Construit un objet de type ostrstream.

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

ostrstream ::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 strstream ::freeze pour obtenir un exemple qui utilise freeze.

ostrstream ::ostrstream

Construit un objet de type ostrstream.

ostrstream();

ostrstream(char* ptr,
    streamsize count,
    ios_base::openmode _Mode = ios_base::out);

Paramètres

ptr
Mémoire tampon.

count
Taille de la mémoire tampon en octets.

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

Notes

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

  • Si _Mode & ios_base ::app== 0, doit ptr désigner le premier élément d’un tableau d’éléments count et les appels strstreambufdu constructeur (ptr, count, 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, count,strlenptr + ( ptr) ).

ostrstream ::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 qui utilise pcount, consultez strstream::pcount.

ostrstream ::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.

ostrstream ::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 strstream ::str pour un exemple qui utilise str.

Voir aussi

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