fputs， fputws

项目
04/10/2013

写入流的一个字符串。

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

参数

str
输出字符串。
stream
为 FILE 结构的指针。

返回值

如果它是成功的，这些函数都返回一个非负值。在错误，fputs 返回 EOF，并且，fputws 返回 WEOF。如果 str 或 stream 是 null 指针，这些函数调用的参数无效处理程序，如参数验证所述。如果执行允许继续，对 EINVAL 的这些功能集 errno 和返回 EOF 或 WEOF。

请参见 _doserrno、errno、_sys_errlist 和_sys_nerr 有关这些内容的更多信息以及其他情况下，错误代码。

备注

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

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

一般文本例程映射

TCHAR.H 实例	未定义的_UNICODE & _MBCS	定义的_MBCS	定义的_UNICODE
_fputts	fputs	fputs	fputws

要求

功能	必需的标头
fputs	<stdio.h>
fputws	<stdio.h> 或 <wchar.h>

控件个在 Windows 应用商店 apps 不受支持。标准流处理与控件个，stdin，stdout和 stderr，在 C 运行时函数在 Windows 应用商店 apps 之前，可以使用它们必须重定向。有关其他的兼容性信息，请参见中介绍的兼容性。

示例

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