putchar, putwchar
Записывает символ в stdout.
int putchar(
int c
);
wint_t putwchar(
wchar_t c
);
Параметры
- c
Символ, который требуется записать.
Возвращаемое значение
Возвращает записанный символ. Чтобы указать условие ошибки или конца файла, putc и putchar возвращают EOF; putwc и putwchar возвращают WEOF. Для всех четырех процедур используйте функцию ferror или feof для проверки ошибок или конца файла. Если для stream передается указатель на null, эти функции вызывают исключение недопустимого параметра, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, они возвращают EOF или WEOF задают errno значение EINVAL.
См. раздел _doserrno, errno, _sys_errlist, and _sys_nerr для дополнительных сведений по этим и другим кодам возврата.
Заметки
Процедура putc записывает один символ c в текущую позицию выходного потока stream. Любое целое число может быть передано putc, но записываются только младшие 8 бит. Процедура putchar идентична putc( cstdout),. Для каждой процедуры, если возникает ошибка чтения, для потока устанавливается индикатор ошибки. putc и putchar аналогичны fputc и _fputchar соответственно, но реализованы как и функции, и макросы (см. Выбор между функциями и макросами). putwc и putwchar - версии putc и putcharдля расширенных символов соответственно.
Версии с суффиксом _nolock идентичны за исключением того, что они не защищены от взаимодействия с другими потоками. Они могут выполняться быстрее, поскольку не создают дополнительную нагрузку, связанную с блокировкой работы других потоков. Используйте эти функции только в потокобезопасных контекстах, например в однопоточных приложениях или если вызываемая область уже обрабатывает изоляцию потоков.
Универсальное текстовое сопоставление функций
Подпрограмма TCHAR.H |
_UNICODE & _MBCS не определены |
_MBCS определено |
_UNICODE определено |
|---|---|---|---|
_puttchar |
putchar |
putchar |
putwchar |
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
putchar |
<stdio.h> |
putwchar |
<stdio.h> или <wchar.h> |
Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.
Библиотеки
Все версии библиотек времени выполнения C.
Пример
// 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 );
}
Output
This is the line of output