_fputchar, _fputwchar

Artigo
06/09/2015

Grava um caractere em stdout.

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

Parâmetros

c
Caractere a ser gravado.

Valor de retorno

Cada uma dessas funções retorna o caractere escrito. No caso de _fputchar, um valor de retorno de EOF indica um erro. No caso de _fputwchar, um valor de retorno de WEOF indica um erro. Se c for NULL, essas funções gerarão uma exceção de parâmetro inválido, conforme descrito em Validação do parâmetro. Se a execução puder continuar, elas retornarão EOF(ouWEOF) e definirão errno como EINVAL.

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

Comentários

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

Mapeamentos da 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>

O console não tem suporte em aplicativos do Windows Store. Os manipuladores de fluxo padrão associados ao console — stdin, stdout e stderr — devem ser redirecionados antes que as funções de tempo de execução do C possam utilizá-los em aplicativos do Windows Store. Para obter mais 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 )
      ;
}