puts，_putws

将字符串写入到 stdout。

语法

int puts(
   const char *str
);
int _putws(
   const wchar_t *str
);

参数

str
输出字符串。

返回值

如果成功，则返回一个非负值。 如果 puts 失败，则返回 EOF；如果 _putws 失败，则返回 WEOF。 如果 str 是空指针，则将调用无效的参数处理程序，如参数验证中所述。 如果允许执行继续，则函数会将 errno 设置为 EINVAL 并返回 EOF 或 WEOF。

有关这些错误代码和其他错误代码的信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

备注

puts 函数将 str 写入标准输出流 stdout，并将字符串的终止空字符 ('\0') 替换为输出流中的换行字符 ('\n')。

_putws 是 puts 的宽字符版本；如果在 ANSI 模式下打开流，则这两个函数的行为相同。 puts 当前不支持到 UNICODE 流中的输出。

_putwch 使用当前控制台区域设置写入 Unicode 字符。

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

一般文本例程映射

TCHAR.H 例程	_UNICODE 和 _MBCS 未定义	_MBCS 已定义	_UNICODE 已定义
_putts	puts	puts	_putws

要求

例程	必需的标头
puts	<stdio.h>
_putws	<stdio.h>

通用 Windows 平台 (UWP) 应用中不支持控制台。 与控制台、stdin、stdout 和 stderr 关联的标准流句柄必须重定向，然后 C 运行时函数才能在 UWP 应用中使用它们。 有关兼容性的详细信息，请参阅 兼容性。

库

C 运行时库的所有版本。

示例

// crt_puts.c
// This program uses puts to write a string to stdout.

#include <stdio.h>

int main( void )
{
   puts( "Hello world from puts!" );
}

输出

Hello world from puts!

另请参阅

流 I/O
fputs、fputws
fgets、fgetws