putchar, putwchar
Grava um caractere em stdout.
int putchar(
int c
);
wint_t putwchar(
wchar_t c
);
Parâmetros
- c
Caractere a ser gravado.
Valor de retorno
Retorna o caractere escrito. Para indicar um erro ou uma condição de fim de arquivo, putc e putchar retornam EOF; putwc e putwchar retornam WEOF. Para todas as quatro rotinas, use ferror ou feof para verificar a existência de um erro ou fim de arquivo. Se um ponteiro nulo tiver sido passado para stream, essas funções gerarão uma exceção de parâmetro inválido, conforme descrito em Validação do parâmetro. Se a execução puder continuar, elas retornarão EOF ou WEOF e definirão errno como EINVAL.
Para obter mais informações sobre esses e outros códigos de erro, consulte _doserrno, errno, _sys_errlist, and _sys_nerr.
Comentários
A rotina putc grava o único caractere c na saída stream da posição atual. Um número inteiro pode ser passado para putc, mas somente os inferiores a 8 bits são gravados. A rotina putchar é idêntica a putc( c**,** stdout ). Para cada rotina, se um erro de leitura ocorrer, o indicador de erro para o fluxo é definido. putc e putchar são semelhantes a fputc e _fputchar, respectivamente, mas são implementados como funções e como macros (consulte Escolhendo entre funções e macros). putwc e putwchar são versões de caracteres longos de putc e putchar, respectivamente.
As versões com o sufixo _nolock são idênticas, exceto pelo fato de que não são protegidas contra interferência de outros threads. Elas podem ser mais rápidas, uma vez que não incorrem na sobrecarga de bloquear outros threads. Use essas funções somente em contextos de thread-safe, como aplicativos single-threaded ou onde o escopo de chamada já manipula o isolamento do thread.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
putchar |
<stdio.h> |
putwchar |
<stdio.h> ou <wchar.h> |
O console não tem suporte em aplicativos do Windows Store. Os manipuladores de fluxo padrão associados ao console — stdin, stdout e stderr — devem ser redirecionados antes que as funções de tempo de execução do C possam utilizá-los em aplicativos do Windows Store. Para informações adicionais de compatibilidade, consulte Compatibilidade.
Bibliotecas
Todas as versões das Bibliotecas em tempo de execução C.
Exemplo
// crt_putchar.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/
#include <stdio.h>
int main( void )
{
FILE *stream;
char *p, buffer[] = "This is the line of output\n";
int ch;
ch = 0;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putchar( *p );
}
Saída
This is the line of output