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。 当 stream 分别以文本模式或二进制模式打开时，fputws 会将宽字符自变量 str 作为多字节字符串或宽字符串复制到 stream。 函数不会复制终止的 null 字符。

如果在 ANSI 模式下打开流，则这两个函数行为相同。 fputs 当前不支持到 UNICODE 流中的输出。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此状态，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程 _UNICODE 和 _MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
_fputts fputs fputs fputws

要求

函数 必需的标头
fputs <stdio.h>
fputws <stdio.h> 或 <wchar.h>

通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台（stdin、stdout 和 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.

另请参阅

流 I/O
fgets、fgetws
gets、_getws
puts、_putws