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 和 _sys_nerr。

备注

在当前位置，这些函数中都复制str 到输出 stream 。作为多字节字符字符串或宽字符字符串，并根据stream 是否在文本模式或二进制模式打开，fputws 分别复制宽字符参数 str 到 stream。两个函数都不复制终止 null 字符。

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

一般文本例程映射

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