fputc, fputwc

Статья
04/10/2013

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

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

Параметры

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

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

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

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

Заметки

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

2 Функции ведут себя одинаково, если поток открывается в режиме 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 ) ;

}