fputc, fputwc

Artigo
08/25/2010

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!!