fputs, fputws

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

Синтаксис

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

Параметры

str
Выходная строка.

stream
Указатель на структуру FILE .

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

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

Дополнительные сведения о кодах ошибок см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

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

Эти две функции ведут себя одинаково, если поток открыт в режиме ANSI. Функция fputs на данный момент не поддерживает вывод данных в поток в кодировке Юникод.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить его, ознакомьтесь с глобальным состоянием в CRT.

Сопоставления подпрограмм универсального текста

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

Требования

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

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

Пример

// 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 );
}

Hello world from fputs.

См. также

Потоковый ввод-вывод
fgets, fgetws
gets, _getws
puts, _putws