putc, putwc
Grava um caractere em um fluxo.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Parâmetros
c
Caractere a ser gravado.stream
Ponteiro para a estrutura FILE.
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 for informado um ponteiro nulo stream, o manipulador de parâmetro inválido será chamado, como descrito em Validação do parâmetro. Se a execução puder continuar, essas funções 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. putwc e putc se comportarão de forma idêntica se o fluxo for aberto no modo de ANSI. No momento, putc não tem suporte para saída em fluxo UNICODE.
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. Para obter mais informações, consulte _putc_nolock, _putwc_nolock.
Mapeamentos da rotina de texto genérico
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
putc |
<stdio.h> |
putwc |
<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_putc.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;
/* Make standard out the stream and write to it. */
stream = stdout;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putc( *p, stream );
}
Saída
This is the line of output