putchar, putwchar
Escreva um caractere a stdout.
int putchar( int c ); wint_t putwchar( wchar_t c );
Parâmetros
- c
Caractere a ser gravado.
Valor de retorno
Retorna o caractere escrito.Para indicar um erro ou uma condição de final de Arquivo, putc e putchar retornam EOF; putwc e retorno WEOFde putwchar .Para todas as quatro rotinas, use ferror ou feof para verificar se um erro ou fim de arquivo.Se passado um ponteiro para streamzero, essas funções gera uma exceção de parâmetro inválido, como descrito em Validação de parâmetro.Se a execução é permitida continuar, retorna EOF ou WEOF e errno defina a EINVAL.
Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre eles, e outros códigos de erro.
Comentários
A rotina de putc grava o caractere único c a saída stream na posição atual.Qualquer número inteiro pode ser passado para putc, mas somente os 8 bits mais baixo são gravados.A rotina de putchar é idêntica a putc(c,stdout ).Para cada rotina, se um erro de leitura ocorre, o indicador de erro para o fluxo é definido.putc e putchar são semelhantes a fputc e a _fputchar, respectivamente, mas são implementados como funções e como macros (consulte Escolha entre as funções e macros.)putwc e putwchar são versões de largo- caractere de putc e de putchar, respectivamente.
As versões com o sufixo de _nolock são idênticas exceto que não são protegidos de interferência por outros segmentos.Podem ser mais rápidos como não incorrem a sobrecarga de bloqueio para fora outros segmentos.Use estas funções somente em contextos thread-safe como aplicativos de thread única ou onde o escopo de chamada já segmento seguro isolamento.
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _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> |
O console não é suportado em aplicativos de Windows Store .Identificadores padrões de fluxo associadas ao console, stdin, stdout, e stderr, devem ser redirecionada antes que as funções de tempo de execução das C pode usar em aplicativos de Windows Store .Para informações extras de compatibilidade Compatibilidade na introdução, consulte.
Bibliotecas
Todas as versões de Bibliotecas em tempo de execução de 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