putc, putwc
Записывает символ в поток.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Параметры
c
Символ, который требуется записать.stream
Указатель на структуру FILE.
Возвращаемое значение
Возвращает записанный символ. Чтобы указать условие ошибки или конца файла, putc и putchar возвращают EOF; putwc и putwchar возвращают WEOF. Для всех четырех процедур используйте функцию ferror или feof для проверки ошибок или конца файла. Если stream является пустым указателем, то вызывается обработчик недопустимых параметров, как описано в разделе Проверка параметров. Если продолжение выполнения разрешено, эти функции возвращают EOF или WEOF и устанавливают для errno значение EINVAL.
См. раздел _doserrno, errno, _sys_errlist, and _sys_nerr для дополнительных сведений по этим и другим кодам возврата.
Заметки
Процедура putc записывает один символ c в текущую позицию выходного потока stream. Любое целое число может быть передано putc, но записываются только младшие 8 бит. Процедура putchar идентична putc( c**,** stdout ). Для каждой процедуры, если возникает ошибка чтения, для потока устанавливается индикатор ошибки. putc и putchar аналогичны fputc и _fputchar соответственно, но реализованы как и функции, и макросы (см. Выбор между функциями и макросами). putwc и putwchar - версии putc и putcharдля расширенных символов соответственно. Поведение putwc и putc идентично, если поток открыт в режиме ANSI-совместимости. putc в настоящее время не поддерживает вывод в поток в юникоде.
Версии с суффиксом _nolock идентичны за исключением того, что они не защищены от взаимодействия с другими потоками. Дополнительные сведения см. в разделе _putc_nolock, _putwc_nolock.
Универсальное текстовое сопоставление функций
Подпрограмма TCHAR.H |
_UNICODE & _MBCS не определены |
_MBCS определено |
_UNICODE определено |
|---|---|---|---|
_puttc |
putc |
putc |
putwc |
Требования
Подпрограмма |
Обязательный заголовок |
|---|---|
putc |
<stdio.h> |
putwc |
<stdio.h> или <wchar.h> |
Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.
Библиотеки
Все версии библиотек времени выполнения C.
Пример
// crt_putc.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;
/* Make standard out the stream and write to it. */
stream = stdout;
for( p = buffer; (ch != EOF) && (*p != '\0'); p++ )
ch = putc( *p, stream );
}
Output
This is the line of output