命名空间
变体
操作

puts

来自 cppreference.com
< c‎ | io
 
C
 
文件输入/输出
类型和对象
函数
文件访问
直接输入/输出
非格式化输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
(C95)
(C95)
格式化输入
(C99)(C99)(C99)(C11)(C11)(C11)
(C99)(C99)(C99)(C11)(C11)(C11)     
 
定义在头文件 <stdio.h> 中
int puts( const char* str );

将以空字符结尾的字符串 str 中的每个字符以及一个额外的换行符 '\n' 写入输出流 stdout，就像通过重复执行 fputc 一样。

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

内容

[编辑] 参数

str - 要写入的字符字符串

[编辑] 返回值

成功时，返回非负值。

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

[编辑] 注释

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 函数

[编辑] 另请参阅

 将字符字符串写入文件流
(函数) [编辑]
(C99)(C11)(C11)(C11)(C11)
 将格式化输出打印到 stdout、文件流或缓冲区
(函数) [编辑]
C++ 文档 用于 puts
检索自 "https://cppreference.cn/mwiki/index.php?title=c/io/puts&oldid=157287"