C 参考手册

定义于头文件 <stdio.h>
int fputs( const char          *str, FILE          *stream );
(C99 前)
int fputs( const char *restrict str, FILE *restrict stream );
(C99 起)

将以NULL结尾的字符串 str 的每个字符写入到输出流 stream ,如同通过重复执行 fputc

不将 str 的空字符写入。

参数

str - 要写入的空终止字符串
stream - 输出流

返回值

成功时,返回非负值。

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

注意

相关函数 puts 后附新换行符到输出,而 fputs 写入不修改的字符串。

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

示例

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

输出:

Hello World

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.21.7.4 The fputs function (p: 331-332)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.19.7.4 The fputs function (p: 297)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.7.4 The fputs function

参阅

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