puts、_putws
向stdout中写入一个字符串。
int puts(
const char *str
);
int _putws(
const wchar_t *str
);
参数
- str
输出字符串
返回值
如果成功返回非负值。 如果 puts 失败,则返回;EOF如果 _putws 失败,则返回 WEOF。 如果 str 是空指针,则会调用无效参数处理程序,如 参数验证 所述。 如果允许继续执行, 函数设置errno 为 EINVAL 并且返回 EOF 或者WEOF.
有关这些属性和其他错误代码的信息,请参见 _doserrno、errno、_sys_errlist 和 _sys_nerr。
备注
puts 函数写入 str到标准输出流 stdout,替换字符串的终止 null 字符 (“\0 ") 将一个换行符 (“\n”) 在输出流。
_putws 是 puts的宽字符版本;如果流在 ANSI 模式下是公开的则两个函数具有相同行为。 puts 当前不支持输出到 UNICODE 流。
在 Windows 2000 和更高版本,_putwch 使用CONSOLE LOCALE设置写入Unicode字符。
一般文本例程映射
TCHAR.H 例程 |
未定义 _UNICODE & _MBCS |
已定义 _MBCS |
已定义 _UNICODE |
---|---|---|---|
_putts |
puts |
puts |
_putws |
要求
例程 |
必需的标头 |
---|---|
puts |
<stdio.h> |
_putws |
<stdio.h> |
控制台在 Windows 应用商店 应用程序中不受支持。 与控制台 stdin、stdout 和 stderr 关联的标准流句柄必须重定向,然后 C 运行时函数才可以在 Windows 应用商店 应用程序中使用它们。 有关兼容性的更多信息,请参见兼容性。
库
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!" );
}
Output
Hello world from puts!