putchar, putwchar
Escreva um caractere para 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 uma condição de erro ou o participante do arquivo, putc e putchar retornar EOF; putwc e putwchar retornar WEOF.Para todas as rotinas de quatro, use ferror or feof para verificar se há um erro ou o participante do arquivo.Se passado um ponteiro nulo para stream, essas funções gerem uma exceção de parâmetro inválido, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, elas retornam EOF ou WEOF and conjunto errno para EINVAL.
See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esses e outros, códigos de erro.
Comentários
The putc rotina grava o único caractere c na saída stream na posição corrente. Qualquer inteiro pode ser passado para putc, mas somente os 8 bits inferiores são gravados. The putchar routine is identical to putc( c**,** stdout ).Para cada rotina, caso ocorra um erro de leitura, o indicador de erro para o fluxo é definido.putc e putchar são semelhantes a fputc e _fputchar, respectivamente, mas são implementadas sistema autônomo funções e macros (consulte Escolhendo entre funções e macros).putwc e putwchar são versões de caractere largo das putc e putchar, respectivamente.
As versões com o _nolock sufixo são idênticas exceto que eles não estão protegidos contra interferência por outros threads.Eles podem ser mais rápidos, pois eles não aumentam a sobrecarga de bloqueio de outros segmentos.Utilizar essas funções em contextos de thread-safe, sistema autônomo aplicativos single-threaded ou onde o escopo de chamada já manipula o thread isolamento.
Mapeamentos de rotina de texto genérica
Rotina TCHAR.H |
_UNICODE & _MBCS não definido |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
putchar |
<stdio.h> |
putwchar |
<stdio.h> ou <wchar.h> |
Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.
Bibliotecas
Todas as versões do C em time de execução bibliotecas.
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