fputc, fputwc
Grava um caractere em um fluxo.
int fputc(
int c,
FILE *stream
);
wint_t fputwc(
wchar_t c,
FILE *stream
);
Parâmetros
c
Caractere a ser gravado.stream
Ponteiro para FILE estrutura.
Valor de retorno
Cada uma dessas funções retorna o caractere escrito.For fputc, um valor retornado EOF indica um erro. For fputwc, um valor retornado WEOF indica um erro. If stream é NULL, essas funções chamar o manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, elas retornam EOF e 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
Cada uma dessas funções escreve o caractere c avanços de um arquivo na posição indicada pelo indicador de posição do arquivo associado (se definidas) e o indicador sistema autônomo apropriado. No caso de fputc e fputwc, o arquivo está associado stream*.* Se o arquivo não pode oferecer suporte a solicitações de posicionamento ou foi aberto em Acrescentar modo, o caractere é acrescentado ao participante do fluxo.
As duas funções tenham comportamento idêntico se o fluxo é aberto no modo ANSI.fputc não oferece suporte atualmente à 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. For more information, see_fputc_nolock, _fputwc_nolock.
Siga comentários específicos de rotina.
Rotina |
Comentários |
|---|---|
fputc |
Equivalente a putc, mas implementado somente sistema autônomo uma função, em vez de uma função e uma macro. |
fputwc |
Versão de caractere largo de fputc. Grava c sistema autônomo um caractere de vários bytes ou um caractere largo de acordo com a stream é aberto no modo de texto ou no modo binário. |
Mapeamentos de rotina de texto genérica
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_fputtc |
fputc |
fputc |
fputwc |
Requisitos
Função |
Cabeçalho necessário |
|---|---|
fputc |
<stdio.h> |
fputwc |
<stdio.h> ou <wchar.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Exemplo
// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
#include <stdio.h>
int main( void )
{
char strptr1[] = "This is a test of fputc!!\n";
char *p;
// Print line to stream using fputc.
p = strptr1;
while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;
}
This is a test of fputc!!