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 a estrutura de ARQUIVO .
Valor de retorno
Retorna o caractere escrito.Para indicar um erro ou uma condição de final de Arquivo, putc e putchar retornam EOF; putwc e retorno WEOFde putwchar .Para todas as quatro rotinas, use ferror ou feof para verificar se um erro ou fim de arquivo.Se passado um ponteiro para streamzero, o manipulador inválido do parâmetro é chamado, como descrito em Validação de parâmetro.Se a execução é permitida continuar, essas funções EOF de retorno ou WEOF e errno defina a EINVAL.
Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre eles, e outros códigos de erro.
Comentários
A rotina de putc grava o caractere único c a saída stream na posição atual.Qualquer número inteiro pode ser passado para putc, mas somente os 8 bits mais baixo são gravados.A rotina de putchar é idêntica a putc(c,stdout ).Para cada rotina, se um erro de leitura ocorre, o indicador de erro para o fluxo é definido.putc e putchar são semelhantes a fputc e a _fputchar, respectivamente, mas são implementados como funções e como macros (consulte Escolha entre as funções e macros.)putwc e putwchar são versões de largo- caractere de putc e de putchar, respectivamente.putwc e putc se comportam de forma idêntica se o fluxo é aberta no modo ANSI.putc não tem suporte para a saída em um fluxo de UNICODE.
As versões com o sufixo de _nolock são idênticas exceto que não são protegidos de interferência por outros segmentos.Para obter mais informações, consulte _putc_nolock, _putwc_nolock.
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _MBCS não definidos |
_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 é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.
Bibliotecas
Todas as versões de Bibliotecas em tempo de execução de 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