Partilhar via


_fputchar, _fputwchar

Grava um caractere em stdout.

Sintaxe

int _fputchar(
   int c
);
wint_t _fputwchar(
   wchar_t c
);

Parâmetros

c
O caractere a ser gravado.

Valor retornado

Cada uma dessas funções retorna o caractere gravado. Para _fputchar, um valor retornado de EOF indica que há um erro. Para _fputwchar, um valor retornado de WEOF indica que há um erro. Se c for NULL, essas funções gerarão uma exceção de parâmetro inválida, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, retornará EOF (_fputwchar retorna WEOF) e eles definirão errno como EINVAL. _fputchar

Para obter mais informações sobre esses e outros códigos de erro, consulte errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

Ambas as funções gravam o argumento c stdout de caractere único e avançam o indicador conforme apropriado. _fputchar é equivalente a fputc( stdout ). Também é equivalente a putchar, mas implementado apenas como uma função, e não como uma função e uma macro. Ao contrário fputc de e putchar, essas funções não são compatíveis com o padrão ANSI.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h _UNICODE e _MBCS não definidos _MBCS definido _UNICODE definido
_fputtchar _fputchar _fputchar _fputwchar

Requisitos

Função Cabeçalho necessário
_fputchar <stdio.h>
_fputwchar <stdio.h> ou <wchar.h>

Não há suporte para o console em aplicativos UWP (Plataforma Universal do Windows). Os identificadores de fluxo padrão associados ao console, stdin, stdout e stderr, devem ser redirecionados antes que as funções em tempo de execução C possam usá-los em aplicativos UWP. Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_fputchar.c
// This program uses _fputchar
// to send a character array to stdout.

#include <stdio.h>

int main( void )
{
    char strptr[] = "This is a test of _fputchar!!\n";
    char *p = NULL;

    // Print line to stream using _fputchar.
    p = strptr;
    while( (*p != '\0') && _fputchar( *(p++) ) != EOF )
      ;
}
This is a test of _fputchar!!

Confira também

E/S de fluxo
fgetc, fgetwc
putc, putwc