basic_ostream::operator<<

Artigo
03/14/2013

Grava o fluxo.

basic_ostream<_Elem, _Tr>& operator<<(
    basic_ostream<_Elem, _Tr>& (*_Pfn)(basic_ostream<_Elem, _Tr>&)
);
basic_ostream<_Elem, _Tr>& operator<<(
    ios_base& (*_Pfn)(ios_base&)
);
basic_ostream<_Elem, _Tr>& operator<<(
    basic_ios<_Elem, _Tr>& (*_Pfn)(basic_ios<_Elem, _Tr>&)
);
basic_ostream<_Elem, _Tr>& operator<<(
    basic_streambuf<_Elem, _Tr> *_Strbuf
);
basic_ostream<_Elem, _Tr>& operator<<(
    bool _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    short _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    unsigned short _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    int __w64 _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    unsigned int __w64 _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    long _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    unsigned long __w64 _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
     long long _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
     unsigned long long _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    float _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    double _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    long double _Val
);
basic_ostream<_Elem, _Tr>& operator<<(
    const void *_Val
);

Parâmetros

_Pfn
Um ponteiro de função.
_Strbuf
Um ponteiro para um objeto de stream_buf .
_Val
Um elemento para gravar no fluxo.

Valor de retorno

Uma referência ao objeto de basic_ostream.

Comentários

O cabeçalho de <ostream> também define vários operadores globais de inserção.Para mais informações, consulte operator<< (<ostream>).

A primeira função de membro garante que uma expressão de formulário ostr << endl chama endl(ostr), e então retorna *this.A segunda e terceira funções garantem que outros manipuladores, como hex, se comportem da mesma forma.As funções restantes são todas funções de saída formatadas.

a função

basic_ostream<_Elem, _Tr>& operator<<(basic_streambuf<Elem, Tr> *_Strbuf);

extrai os elementos de _Strbuf, se _Strbuf não é um ponteiro zero, e inserir-los.A extração para no final do arquivo, ou se uma extração lança uma exceção (que é rethrown).Também para, sem extrair o elemento em questão, se uma inserção falhar.Se a função não insere nenhum elemento, ou se uma extração gera uma exceção, as chamadas de função setstatefailbit().Em qualquer caso, a função retorna *this.

a função

basic_ostream<_Elem, _Tr>& operator<<(bool _Val);

converte o _Val a um campo booleano e inseri-lo chamando use_facet<num_put<Elem, OutIt>(getloc).colocado(OutIt(rdbuf), *this, getloc, val).Aqui, OutIt é definido como ostreambuf_iterator<Elem, Tr>.a função retorna *this.

Funções

basic_ostream<_Elem, _Tr>& operator<<(short _Val);
basic_ostream<_Elem, _Tr>& operator<<(unsigned short _Val);
basic_ostream<_Elem, _Tr>& operator<<(int _Val);
basic_ostream<_Elem, _Tr>& operator<<(unsigned int __w64 _Val);
basic_ostream<_Elem, _Tr>& operator<<(long _Val);
basic_ostream<_Elem, _Tr>& operator<<(unsigned long _Val);
basic_ostream<_Elem, _Tr>& operator<<(long long _Val);
basic_ostream<_Elem, _Tr>& operator<<(unsigned long long _Val);
basic_ostream<_Elem, _Tr>& operator<<(const void *_Val);

cada converter _Val a um campo numérico e inseri-lo chamando use_facet<num_put<Elem, OutIt>(getloc). put(OutIt(rdbuf), *this, getloc, val).Aqui, OutIt é definido como ostreambuf_iterator<Elem, Tr>.a função retorna *this.

Funções

basic_ostream<_Elem, _Tr>& operator<<(float _Val);
basic_ostream<_Elem, _Tr>& operator<<(double _Val);
basic_ostream<_Elem, _Tr>& operator<<(long double _Val);

cada _Val de converter para um campo numérico e inseri-lo chamando use_facet<num_put<Elem, OutIt>(getloc). put(OutIt(rdbuf), *this, getloc, val).Aqui, OutIt é definido como ostreambuf_iterator<Elem, Tr>.a função retorna *this.

Exemplo

// basic_ostream_op_write.cpp
// compile with: /EHsc
#include <iostream>
#include <string.h>

using namespace std;

ios_base& hex2( ios_base& ib )
{
   ib.unsetf( ios_base::dec );
   ib.setf( ios_base::hex );
   return ib;
}

basic_ostream<char, char_traits<char> >& somefunc(basic_ostream<char, char_traits<char> > &i)
{
   if ( i == cout )
   {
      i << "i is cout" << endl;
   }
   return i;
}

class CTxtStreambuf : public basic_streambuf< char, char_traits< char > >
{
public:
   CTxtStreambuf(char *_pszText)
   {
      pszText = _pszText;
      setg(pszText, pszText, pszText+strlen(pszText));
   };
          char *pszText;
};

int main( )
{
   cout << somefunc;
   cout << 21 << endl;

   hex2(cout);
   cout << 21 << endl;

   CTxtStreambuf f("text in streambuf");
   cout << &f << endl;
}