putc, putwc
Символ запись в поток.
int putc(
int c,
FILE *stream
);
wint_t putwc(
wchar_t c,
FILE *stream
);
Параметры
c
Символ, который требуется записать.stream
Указатель на структуру файл.
Возвращаемое значение
Возвращает, символ.Чтобы указать условие ошибки или элемент - файла, putc и putchar возвращают значение EOF; putwc и putwchar возвращают значение WEOF.Для всех 4 процедур используйте функцию 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