Compartilhar via


operator<< (<ostream>)

Grava vários tipos para o 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 _Ty>
    basic_ostream<_Elem, _Tr>& operator<<(
        basic_ostream<_Elem, _Tr>&& _Ostr,
        Ty _Val
    );

Parâmetros

  • _Ch
    Um caractere.

  • _Elem
    O tipo de elemento.

  • _Ostr
    Um objeto basic_ostream.

  • _Str
    Uma cadeia de caracteres.

  • _Tr
    Características de caractere.

  • _Val
    O tipo

Valor de retorno

O fluxo.

Comentários

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

A função do 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::comprimento()_Strde início da sequência em _Str, e insere a sequência. Se N <_Ostr.largura, a função também insere uma repetição de _Ostr.width - caracteres de preenchimento de Em. A repetição precede a sequência se (_Ostr.sinalizadores &adjustfield ! = esquerdo. Caso contrário, a repetição segue a sequência. A função retorna _Ostr.

A função do 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, a função também insere uma repetição de _Ostr.width - caracteres de preenchimento 1. A repetição precede a sequência se _Ostr.flags & adjustfield != left. Caso contrário, a repetição segue a sequência. Retorna _Ostr.

A função do modelo

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

comporta-se igual a

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

exceto pelo fato de que cada elemento _Ch de início da sequência em _Str é convertido em um objeto do tipo Elem chamando _Ostr.colocado(_Ostr.alargue_Ch()).

A função do modelo

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

comporta-se igual a

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 do modelo

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

comporta-se igual a

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

(Não precisa ampliar os elementos antes de inserir.)

A função do modelo

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

comporta-se igual a

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

(Não precisa ampliar _Ch antes de inserir.)

A função do modelo

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

retorna _Ostr << (const char *)_Str.

A função do modelo

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

retorna _Ostr << (char)_Ch.

A função do modelo:

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

retorna _Ostr << (const char *)_Str.

A função do modelo:

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

retorna _Ostr << (char)_Ch.

A função do modelo:

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

retorna _Ostr << _Val (e converte Referência de RValue a _Ostr a um lvalue no processo).

Exemplo

Consulte ocorrência para obter um exemplo usando operator<<.

Requisitos

ostream <deCabeçalho: >

Namespace: std

Consulte também

Referência

basic_ostream::operator<<

Programação iostream

Convenções iostreams