<ostream> operadores

O <ostream> cabeçalho fornece os seguintes operadores:

operator<<

Grava vários tipos no fluxo.

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);

Parâmetros

_Ch
Um personagem.

_Elem
O tipo de elemento.

_Ostr
Um objeto basic_ostream.

STR
Uma cadeia de caracteres.

_Tr
Traços de caráter.

Val
O tipo

Valor de retorno

O fluxo.

Observações

A basic_ostream classe também define vários operadores de inserção. Para obter mais informações, consulte basic_ostream::operator<<.

A função de modelo

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

determina o comprimento N = traits_type::length(str) da sequência que começa em str e insere a sequência. Se N <_Ostr.largura, então a função também insere uma repetição de _Ostr.width - N caracteres de preenchimento. A repetição precede a sequência se (_Ostr. bandeiras & adjustfield != esquerda. Caso contrário, a repetição segue a sequência. A função retorna _Ostr.

A função de modelo

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

insere o elemento _Ch. Se 1 <_Ostr.width, então a função também insere uma repetição de - 1 caracteres de _Ostr.width preenchimento. A repetição precede a sequência se _Ostr.flags & adjustfield != left. Caso contrário, a repetição segue a sequência. Ele retorna _Ostr.

A função de modelo

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

comporta-se da mesma forma que

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

exceto que cada elemento _Ch da sequência que começa em str é convertido em um objeto do tipo Elem_Ostr. put(_Ostr.widen(_Ch)).

A função de modelo

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

comporta-se da mesma forma que

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

exceto que _Ch é convertido em um objeto do tipo Elem chamando _Ostr.put( _Ostr.widen( _Ch )).

A função de modelo

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

comporta-se da mesma forma que

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

(Não é necessário alargar os elementos antes de os inserir.)

A função de modelo

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

comporta-se da mesma forma que

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

(Não é necessário alargar _Ch antes de inseri-lo.)

A função de modelo

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

devoluções _Ostr << (const char *)str.

A função de modelo

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

devoluções _Ostr << (char)_Ch.

A função de modelo:

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

devoluções _Ostr << (const char *)str.

A função de modelo:

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

devoluções _Ostr << (char)_Ch.

A função de modelo:

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

retorna _Ostr << val (e converte uma referência RValue em _Ostr um lvalue no processo).

Exemplo

Consulte flush para obter um exemplo usando operator<<.

Ver também

<ostream>