puts

< c‎ | io
 
 
文件输入/输出
类型与对象
函数
文件访问
直接输入/输出
无格式输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
有格式输入
 
定义于头文件 <stdio.h>
int puts( const char *str );

写入每个来自空终止字符串 str 的字符及附加换行符 '\n' 到输出流 stdout ,如同以重复执行 putc 写入。

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

参数

str - 要写入的字符串

返回值

成功时返回非负值

失败时,返回 EOF 并设置 stdout错误指示器(见 ferror() )。

注意

puts 函数后附一个换行字符到输出,而 fputs 不这么做。

不同的实现返回不同的非负数:一些返回最后写入的字符,一些返回写入的字符数(或若字符串长于 INT_MAX 则返回它),一些简单地返回非负常量。

在重定向 stdout 到文件时,导致 puts 失败的典型原因是用尽了文件系统的空间。

示例

#include <stdio.h>
 
int main(void)
{
    int rc = puts("Hello World");
 
    if (rc == EOF)
       perror("puts()"); // POSIX 要求设置 errno
}

输出:

Hello World

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.21.7.9 The puts function (p: 333)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.19.7.10 The puts function (p: 299)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.7.10 The puts function

参阅

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