_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.

Retornar valor

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 são definidos 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 escrevem o argumento c de caractere único e stdout avançam o indicador conforme apropriado. _fputchar é equivalente a fputc( stdout ). Também é equivalente a putchar, mas implementado apenas como uma função, em vez de 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, consulte Estado global na 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 — , stdoute stderr—stdin devem ser redirecionados antes que as funções de 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