fputc, fputwc

Статья
06/09/2015

Записывает символ в поток.

int fputc(
   int c,
   FILE *stream 
);
wint_t fputwc(
   wchar_t c,
   FILE *stream 
);

Параметры

c
Символ, который требуется записать.
stream
Указатель на структуру FILE.

Возвращаемое значение

Каждая из этих функций возвращает записанный символ. Возвращаемое значение EOF для функции fputc указывает на ошибку. Возвращаемое значение WEOF для функции fputwc указывает на ошибку. Если stream имеет значение NULL, эти функции вызывают обработчик недопустимого параметра, как описано в Проверка параметров. Если продолжение выполнения разрешено, эти функции возвращают EOF и устанавливают для errno значение EINVAL.

См. раздел _doserrno, errno, _sys_errlist, and _sys_nerr для дополнительных сведений по этим и другим кодам возврата.

Заметки

Каждая из этих функций записывает символ c в файл на позицию, указанную связанным индикатором позиции файла (если определен), и соответственно перемещает индикатор. В случае fputc и fputwc, файл связан с stream*.* Если файл не поддерживает запросы размещения или открыт в режиме добавления, символ добавляется в конец потока.

Поведение этих функций идентично, если поток открыт в режиме ANSI-совместимости. fputc в настоящее время не поддерживает вывод в поток в Юникоде.

Версии с суффиксом _nolock идентичны за исключением того, что они не защищены от взаимодействия с другими потоками. Для получения дополнительной информации см._fputc_nolock, _fputwc_nolock.

Замечания относительно особенностей процедур.

Подпрограмма	Примечания
fputc	Эквивалентна putc, но реализуется только как функция, а не как функция и макрос.
fputwc	Версия fputc для работы с расширенными символами. Записывает c как многобайтовый или расширенный символ согласно тому, открыт ли stream в текстовом режиме или в бинарном режиме.

Универсальное текстовое сопоставление функций

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_fputtc	fputc	fputc	fputwc

Требования

Функция	Обязательный заголовок
fputc	<stdio.h>
fputwc	<stdio.h> или <wchar.h>

Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

// crt_fputc.c
// This program uses fputc
// to send a character array to stdout.
 

#include <stdio.h>

int main( void )
{
   char strptr1[] = "This is a test of fputc!!\n";
   char *p;

   // Print line to stream using fputc. 
   p = strptr1;
   while( (*p != '\0') && fputc( *(p++), stdout ) != EOF ) ;

}