puts

定义于头文件 `<stdio.h>`
int puts( const char* str );

将空终止字符串 str 中的每个字符和一个额外的换行符 '\n' 写入到输出流 stdout，如同重复执行 fputc 一样。

不会写入来自 str 的终止空字符。

内容

1 参数
2 返回值
3 注意
4 示例
5 参考
6 参见

[编辑] 参数

str

-

要写入的字符字符串

[编辑] 返回值

成功时，返回一个非负值。

失败时，返回 EOF 并设置 error 指示器（参见 ferror()）在 stream 上。

[编辑] 注意

puts 函数会在输出中追加换行符，而 fputs 函数则不会。

不同的实现返回不同的非负数：有些返回写入的最后一个字符，有些返回写入的字符数（或者如果字符串比它长，则返回 INT_MAX），有些只是简单地返回一个非负常数。

puts 失败的典型原因是文件系统空间不足，当 stdout 重定向到文件时。

[编辑] 示例

运行此代码

#include <stdio.h>
 
int main(void)
{
    int rc = puts("Hello World");
 
    if (rc == EOF)
        perror("puts()"); // POSIX requires that errno is set
}

输出

Hello World

[编辑] 参考

C23 标准 (ISO/IEC 9899:2024)

7.21.7.9 puts 函数 (p: TBD)

C17 标准 (ISO/IEC 9899:2018)

7.21.7.9 puts 函数 (p: TBD)

C11 标准 (ISO/IEC 9899:2011)

7.21.7.9 puts 函数 (p: 333)

C99 标准 (ISO/IEC 9899:1999)

7.19.7.10 puts 函数 (p: 299)

C89/C90 标准 (ISO/IEC 9899:1990)

7.9.7.10 puts 函数

[编辑] 参见

fputs	向文件流写入一个字符字符串 (函数) [编辑]
printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11)	向 stdout、文件流或缓冲区打印格式化输出 (函数) [编辑]
C++ 文档关于 puts

编译器支持
语言
头文件
类型支持
程序工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作