fputs, fputws

Статья
04/10/2013

Создайте строку в поток.

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

Параметры

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

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

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

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

Заметки

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

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