fputs, fputwsfputs, fputws

Записывает строку в поток.Writes a string to a stream.

СинтаксисSyntax

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

ПараметрыParameters

strstr
Выходная строка.Output string.

вышестоящийstream
Указатель на структуру FILE.Pointer to FILE structure.

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

Каждая из этих функций возвращает неотрицательное значение при успешном выполнении.Each of these functions returns a nonnegative value if it is successful. При возникновении ошибки fputs и Fputws возвращают EOF.On an error, fputs and fputws return EOF. Если str или Stream является пустым указателем, эти функции вызывают обработчик недопустимых параметров, как описано в разделе Проверка параметров.If str or stream is a null pointer, these functions invoke the invalid parameter handler, as described in Parameter Validation. Если выполнение может быть продолжено, эти функции устанавливают значение еинвал , а затем fputs возвращает EOF, а fputws возвращает WEOF.If execution is allowed to continue, these functions set errno to EINVAL and then fputs returns EOF, and fputws returns WEOF.

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.See _doserrno, errno, _sys_errlist, and _sys_nerr for more information on these, and other, error codes.

КомментарииRemarks

Каждая из этих функций копирует str в выходной поток в текущей позиции.Each of these functions copies str to the output stream at the current position. fputws копирует str аргумента расширенных символов в Stream в виде строки многобайтовых символов или строки расширенных символов в зависимости от того, открыт ли поток в текстовом или двоичном режиме соответственно.fputws copies the wide-character argument str to stream as a multibyte-character string or a wide-character string according to whether stream is opened in text mode or binary mode, respectively. Ни одна из функций не копирует завершающий нуль-символ.Neither function copies the terminating null character.

Эти две функции ведут себя одинаково, если поток открыт в режиме ANSI.The two functions behave identically if the stream is opened in ANSI mode. fputs в настоящее время не поддерживает вывод в поток Юникода.fputs does not currently support output into a UNICODE stream.

По умолчанию глобальное состояние этой функции ограничивается приложением.By default, this function's global state is scoped to the application. Чтобы изменить это, см. раздел глобальное состояние в CRT.To change this, see Global state in the CRT.

Универсальное текстовое сопоставление функцийGeneric-Text Routine Mappings

Подпрограмма TCHAR.HTCHAR.H routine _UNICODE и _MBCS не определены_UNICODE & _MBCS not defined _MBCS определено_MBCS defined _UNICODE определено_UNICODE defined
_fputts_fputts fputsfputs fputsfputs fputwsfputws

ТребованияRequirements

ФункцияFunction Обязательный заголовокRequired header
fputsfputs <stdio.h>
fputwsfputws <stdio.h> или <wchar.h><stdio.h> or <wchar.h>

Консоль не поддерживается в приложениях универсальная платформа Windows (UWP).The console is not supported in Universal Windows Platform (UWP) apps. Стандартные дескрипторы потока, связанные с консолью (stdin, stdout и stderr), необходимо перенаправить, прежде чем функции времени выполнения C смогут использовать их в приложениях UWP.The standard stream handles that are associated with the console—stdin, stdout, and stderr—must be redirected before C run-time functions can use them in UWP apps. Дополнительные сведения о совместимости см. в статье Compatibility.For additional compatibility information, see Compatibility.

ПримерExample

// 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.

См. также разделSee also

Потоковый ввод-выводStream I/O
fgets, fgetwsfgets, fgetws
gets, _getwsgets, _getws
puts, _putwsputs, _putws