fputc, fputwc

Artigo
03/12/2013

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 a estrutura de FILE .

Valor de retorno

Cada uma dessas funções retorna o caractere escrito.Para fputc, um valor de retorno de EOF indica um erro.Para fputwc, um valor de retorno de WEOF indica um erro.Se stream é NULL, essas funções chamam o manipulador de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, retorna EOF 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

Cada uma dessas funções grava o caractere único c a um arquivo na posição indicada pelo indicador de posição associado do arquivo () e se definido por avanços o indexador conforme apropriado.No caso de fputc e de fputwc, o arquivo é associado com stream*.* Se o arquivo não pode suportar solicitações de posicionamento nem foi aberto no acrescentará o modo, o caractere é acrescentada ao final de fluxo.

As duas funções se comportam de forma idêntica se o fluxo é aberta no modo ANSI.fputc 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_fputc_nolock, _fputwc_nolock.

Os comentários Rotina- específicos a seguir.

Rotina	Comentários
fputc	Equivalente a putc, mas somente implementado como uma função, em vez de como uma função e uma macro.
fputwc	Versão de Largo- caractere de fputc.Grava c como um caractere de multibyte ou um caractere amplo acordo com o que stream é aberto no modo de texto ou no modo de binário.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_MBCS definido	_UNICODE definido
_fputtc	fputc	fputc	fputwc

Requisitos

Função	Cabeçalho necessário
fputc	<stdio.h>
fputwc	<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.

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 ) ;

}