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 是 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 );
}
.NET Framework 等效项
System::IO::StreamWriter::Write