fputs, fputws

Статья
06/09/2015

Записывает строку в поток.

int fputs( 
   const char *str,
   FILE *stream 
);
int fputws( 
   const wchar_t *str,
   FILE *stream 
);

Параметры

str
Выходная строка.
stream
Указатель на структуру FILE.

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

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

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

Заметки

Каждая из этих функций копирует str в выходной stream в текущую позицию. fputws копирует расширенную строку str в поток stream как строку расширенных символов или многобайтовых символов в зависимости от того, открыт ли stream в текстовом или бинарном режиме. Ни одна из функций не копирует завершающий нулевой символ.

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

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

Подпрограмма TCHAR.H	_UNICODE & _MBCS не определены	_MBCS определено	_UNICODE определено
_fputts	fputs	fputs	fputws

Требования

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

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

Пример

// crt_fputs.c
// This program uses fputs to write
// a single line to the stdout stream.

#include <stdio.h>

int main( void )
{
   fputs( "Hello world from fputs.\n", stdout );
}