Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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!!