Partilhar via


Funções <ostream>

Estas são as funções de modelo globais definidas em <ostream>. Para funções de membro, consulte a documentação da Classe basic_ostream.

endl
ends
flush
troca

endl

Termina uma linha e libera o buffer.

template class<Elem, Tr>
basic_ostream<Elem, Tr>& endl(
   basic_ostream<Elem, Tr>& Ostr);

Parâmetros

Elem
O tipo de elemento.

Ostr
Um objeto do tipo basic_ostream.

Tr
Características de caractere.

Valor de retorno

Um objeto do tipo basic_ostream.

Comentários

O manipulador chama Ostr.put(Ostr.widen('\n')) e, em seguida, chama Ostr.flush. Ele retorna Ostr.

Exemplo

// ostream_endl.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   cout << "testing" << endl;
}
testing

extremidades

Termina uma cadeia de caracteres.

template class<Elem, Tr>
basic_ostream<Elem, Tr>& ends(
   basic_ostream<Elem, Tr>& Ostr);

Parâmetros

Elem
O tipo de elemento.

Ostr
Um objeto do tipo basic_ostream.

Tr
Características de caractere.

Valor de retorno

Um objeto do tipo basic_ostream.

Comentários

O manipulador chama Ostr.put(Elem('\0')). Ele retorna Ostr.

Exemplo

// ostream_ends.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   cout << "a";
   cout << "b" << ends;
   cout << "c" << endl;
}
ab c

flush

Libera o buffer.

template class<Elem, Tr>
basic_ostream<Elem, Tr>& flush(
   basic_ostream<Elem, Tr>& Ostr);

Parâmetros

Elem
O tipo de elemento.

Ostr
Um objeto do tipo basic_ostream.

Tr
Características de caractere.

Valor de retorno

Um objeto do tipo basic_ostream.

Comentários

O manipulador chama Ostr.flush. Ele retorna Ostr.

Exemplo

// ostream_flush.cpp
// compile with: /EHsc
#include <iostream>

int main( )
{
   using namespace std;
   cout << "testing" << flush;
}
testing

troca

Troca os valores de dois objetos basic_ostream.

template <class Elem, class Tr>
void swap(
   basic_ostream<Elem, Tr>& left,
   basic_ostream<Elem, Tr>& right);

Parâmetros

Elem
O tipo de elemento.

Tr
Características de caractere.

esquerda
Uma referência lvalue a um objeto basic_ostream.

direita
Uma referência lvalue a um objeto basic_ostream.

Comentários

A função de modelo swap executa left.swap(right).

Confira também

<ostream>