basic_ostream::operator<<

Artigo
06/09/2015

Gravações no 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 a serem gravados 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 obter mais informações, consulte operator<< (<ostream>).

A primeira função de membro assegura que uma expressão de formato ostr << endl chama endl(ostr), e retorna em *this. A segunda e a terceira funções verifique se os manipuladores, como hexadecimal, se comportem de forma semelhante. As funções restantes são todas funções de saída formatada.

A função

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

extrai os elementos de _Strbuf, se _Strbuf não for um ponteiro nulo, e inserir. A extração para no final do arquivo, ou se uma extração gerará 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 inserirá nenhum elemento, ou se uma extração gerou uma exceção, as chamadas de função setstate(failbit). Em qualquer caso, a função retornará *this.

A função

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

converte o _Val a um campo booliano 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.

As 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 _Val a converter 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.

As 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 em 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;
}