<ostream>, opérateurs

L’en-tête <ostream> fournit les opérateurs suivants :

operator<<

Écrit différents types dans le flux.

template <class _Elem, class _Tr>
basic_ostream<_Elem, _Tr>& operator<<(
    basic_ostream<_Elem, _Tr>& _Ostr,
    const Elem* str);

template <class _Elem, class _Tr>
basic_ostream<_Elem, _Tr>& operator<<(
    basic_ostream<_Elem, _Tr>& _Ostr,
    Elem _Ch);

template <class _Elem, class _Tr>
basic_ostream<_Elem, _Tr>& operator<<(
    basic_ostream<_Elem, _Tr>& _Ostr,
    const char* str);

template <class _Elem, class _Tr>
basic_ostream<_Elem, _Tr>& operator<<(
    basic_ostream<_Elem, _Tr>& _Ostr,
    char _Ch);

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    const char* str);

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _ostr,
    char _Ch);

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    const signed char* str);

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    signed char _Ch);

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    const unsigned char* str);

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    unsigned char _Ch);

template <class _Elem, class _Tr, class T>
basic_ostream <_Elem, _Tr>& operator<<(
    basic_ostream<_Elem, _Tr>&& _Ostr,
    Ty val);

Paramètres

_Ch
Un caractère.

_Elem
Type de l’élément.

_Ostr
Objet basic_ostream.

Str
Chaîne caractère.

_Tr
Caractéristiques de caractère.

Val
Le type

Valeur de retour

Flux.

Notes

La classe basic_ostream définit également plusieurs opérateurs d’insertion. Pour plus d’informations, consultez basic_ostream::operator<<.

La fonction de modèle

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _ostr,
    const Elem *str);

détermine la longueur N = traits_type::length(str) de la séquence commençant à str et insère la séquence. Si la largeur<_Ostr., la fonction insère également une répétition de caractères de _Ostr.width remplissage N. La répétition précède la séquence si (_Ostr. flags & adjustfield  != left. Sinon, la répétition suit la séquence. La fonction retourne _Ostr.

La fonction de modèle

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    Elem _Ch);

insère l’élément _Ch. Si 1 <_Ostr.width, la fonction insère également une répétition de - _Ostr.width 1 caractères de remplissage. La répétition précède la séquence si _Ostr.flags & adjustfield != left. Sinon, la répétition suit la séquence. Elle retourne _Ostr.

La fonction de modèle

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    const char *str);

se comporte comme

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    const Elem *str);

sauf que chaque élément

La fonction de modèle

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    char _Ch);

se comporte comme

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    Elem _Ch);

sauf que _Ch est converti en objet de type Elem en appelant _Ostr.put( _Ostr.widen( _Ch )).

La fonction de modèle

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    const char *str);

se comporte comme

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    const Elem *str);

(Elle n’a pas besoin d’élargir les éléments avant de les insérer.)

La fonction de modèle

template <class _Tr>
basic_ostream<char, Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    char _Ch);

se comporte comme

template <class _Elem, class _Tr>
basic_ostream<Elem, _Tr>& operator<<(
    basic_ostream<Elem, _Tr>& _Ostr,
    Elem _Ch);

(Il n’est pas obligé d’élargir _Ch avant de l’insérer.)

La fonction de modèle

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    const signed char *str);

Retourne _Ostr << (const char *)str.

La fonction de modèle

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    signed char _Ch);

Retourne _Ostr << (char)_Ch.

La fonction de modèle

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    const unsigned char *str);

Retourne _Ostr << (const char *)str.

La fonction de modèle

template <class _Tr>
basic_ostream<char, _Tr>& operator<<(
    basic_ostream<char, _Tr>& _Ostr,
    unsigned char _Ch);

Retourne _Ostr << (char)_Ch.

La fonction de modèle

template <class _Elem, class _Tr, class T>
basic_ostream<_Elem, _Tr>& operator<<(
    basic_ostream<char, _Tr>&& _Ostr,
    T val);

retourne _Ostr << val (et convertit une référence RValue à _Ostr en lvalue dans le processus).

Exemple

Consultez flush pour obtenir un exemple qui utilise operator<<.

Voir aussi

<ostream>