putchar, putwchar

Grava um caractere em stdout.

Sintaxe

int putchar(
   int c
);
wint_t putwchar(
   wchar_t c
);

Parâmetros

c
O caractere a ser gravado.

Retornar valor

Retorna o caractere gravado. Para indicar um erro ou condição de fim de arquivo, putc e putchar retornar . putwcputwcharWEOFEOF Para todas as quatro rotinas, use ferror ou para verificar se há um erro ou feof fim do arquivo. Se passado um ponteiro nulo para stream, 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, eles retornarão EOF ou WEOF, e definirão errno como EINVAL.

Para obter mais informações sobre códigos de retorno, confira errno, _doserrno, _sys_errlist e _sys_nerr.

Comentários

A rotina putc grava o único caractere c para a saída stream na posição atual. Qualquer inteiro pode ser passado para putc, mas somente os 8 bits inferiores são gravados. A putchar rotina é idêntica à putc( c, stdout ). Para cada rotina, se ocorrer um erro de leitura, o indicador de erro para o fluxo será definido. putce são semelhantes a fputc e , respectivamente, mas são implementados tanto como funções quanto como macros (consulte Recomendações para escolher entre funções e putchar_fputcharmacros). putwc e putwchar são as versões de caractere largo de putc e putchar, respectivamente.

As versões com o sufixo _nolock são idênticas, exceto que não estão protegidas contra interferência de outros threads. Eles podem ser mais rápidos, uma vez que não incorrem na sobrecarga de bloquear outros threads. Use estas funções apenas em contextos thread-safe, como aplicativos de thread único ou em que o escopo de chamada já trata do isolamento de threads.

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
_puttchar	putchar	putchar	putwchar

Requisitos

Rotina	Cabeçalho necessário
putchar	<stdio.h>
putwchar	<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.

Bibliotecas

Todas as versões das bibliotecas em tempo de execução C.

Exemplo

// crt_putchar.c
/* This program uses putc to write buffer
* to a stream. If an error occurs, the program
* stops before writing the entire buffer.
*/

#include <stdio.h>

int main( void )
{
   FILE *stream;
   char *p, buffer[] = "This is the line of output\n";
   int  ch;

   ch = 0;

   for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
      ch = putchar( *p );
}

Saída

This is the line of output

Confira também

E/S de fluxo
fputc, fputwc
getc, getwc