putc, putwc
Escreva 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 ARQUIVO estrutura.
Valor de retorno
Retorna o caractere escrito.Para indicar uma condição de erro ou o participante do arquivo, putc e putchar retornar EOF; putwc e putwchar retornar WEOF.Para todas as rotinas de quatro, use ferror or feof para verificar se há um erro ou o participante do arquivo.Se um ponteiro nulo para psistema autônomosedstream, o manipulador de parâmetro inválido é invocado, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções retornam EOF ou WEOF and conjunto errno para EINVAL.
See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esses e outros, códigos de erro.
Comentários
The putc rotina grava o único caractere c na saída stream na posição corrente. Qualquer inteiro pode ser passado para putc, mas somente os 8 bits inferiores são gravados. The putchar routine is identical to putc( c**,** stdout ).Para cada rotina, caso ocorra um erro de leitura, o indicador de erro para o fluxo é definido.putc e putchar são semelhantes a fputc e _fputchar, respectivamente, mas são implementadas sistema autônomo funções e macros (consulte Escolhendo entre funções e macros).putwc e putwchar são versões de caractere largo das putc e putchar, respectivamente. putwc e putc tenham comportamento idêntico se o fluxo é aberto no modo ANSI. putc atualmente não suporta saída em um fluxo UNICODE.
As versões com o _nolock sufixo são idênticas exceto que eles não estão protegidos contra interferência por outros threads.Para obter mais informações, consulte _putc_nolock, _putwc_nolock.
Mapeamentos de rotina de texto genérica
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> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Bibliotecas
Todas as versões do C em time de execução bibliotecas.
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