Namespaces
Variants

puts

From cppreference.net
< c ‎ | io
定义于头文件 <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要求必须设置errno
}

输出:

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函数(页数:299)
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 7.9.7.10 puts 函数

参考

将字符串写入文件流
(函数)
将格式化输出打印到 stdout 、文件流或缓冲区
(函数)