std::basic_ostream::put - cppreference.com

De cppreference.com


`basic_ostream& put( char_type ch );`

Escreve ch personagem para o fluxo de saída.

Original:

Writes character ch to the output stream.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Esta função é uma função de saída não formatada: ela iniciar a execução através da construção de um objeto de sentry tipo, o que esvazia os buffers de saída tie()'d se necessário e verifica os erros de fluxo. Após a construção, se os retornos de sentinela objeto false, a função retorna sem tentar qualquer saída. Se uma exceção é lançada durante a saída, então ios :: badbit está definido (a exceção é suprimida a menos exceptions()&badbit) != 0, caso em que é relançada)

Original:

This function is an unformatted output function: it begin execution by constructing an object of type sentry, which flushes the tie()'d output buffers if necessary and checks the stream errors. After construction, if the sentry object returns false, the function returns without attempting any output. If an exception is thrown during output, then ios::badbit is set (the exception is suppressed unless exceptions()&badbit) != 0, in which case it is rethrown)

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Parâmetros

caracteres para escrever

Original:

character to write

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Valor de retorno

*this

Notas

Ao contrário de funções de saída formatados, esta função não define o failbit se a saída não.

Original:

Unlike formatted output functions, this function does not set the failbit if the output fails.

The text has been machine-translated via Google Translate.
You can help to correct and verify the translation. Click here for instructions.

Exemplo

#include <fstream>
#include <iostream>
int main()
{
    std::cout.put('a'); // normal usage
    std::cout.put('\n');

    std::ofstream s("/does/not/exist/");
    s.clear(); // pretend the stream is good
    std::cout << "Unformatted output: ";
    s.put('c'); // this will set badbit, but not failbit
    std::cout << " fail=" << bool(s.rdstate() & s.failbit);
    std::cout << " bad=" << s.bad() << '\n';
    s.clear();
    std::cout << "Formatted output:   ";
    s << 'c'; // this will set badbit and failbit
    std::cout << " fail=" << bool(s.rdstate() & s.failbit);
    std::cout << " bad=" << s.bad() << '\n';
}

Saída:

a
Unformatted output:  fail=0 bad=1
Formatted output:    fail=1 bad=1

Veja também


	inserções de dados de caracteres Original: inserts character data The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função) [edit]

	insere blocos de caracteres Original: inserts blocks of characters The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (função pública membro) [edit]