[函数快查] fputc -- 将一个字符写入到文件中

> **fputc 函数文档**

**函数概要：**

fputc 函数用于将一个字符写入到指定的文件中并推进文件的位置指示器（用来指示接下来要读写的下一个字符的位置）。

**函数原型：**

```C
#include <stdio.h>
...
int fputc(int c, FILE *stream);
```

**参数解析：**

| **参数** | **含义**                                             |
| ---------- | ------------------------------------------------------ |
| c        | 指定待写入的字符                                     |
| stream   | 该参数是一个 FILE 对象的指针，指定一个待写入的文件流 |

**返回值：**

1. 如果函数没有错误，返回值是写入的字符；
2. 如果函数发生错误，返回值是 EOF。

**备注：**

1. fputc 函数和 [putc](http://bbs.fishc.com/thread-91121-1-1.html) 函数两个的功能和描述基本上是一模一样的，它们的区别主要在于实现上：fputc 是一个函数；而 putc 则是一个宏的实现
2. 一般来说宏产生较大的代码，但是避免了函数调用的堆栈操作，所以速度会比较快。
3. 由于 putc 是由宏实现的，对其参数可能有不止一次的调用，所以不能使用带有副作用（side effects）的参数。

小甲鱼温馨提示：

我知道上面第 3 点可能会让有些童鞋感到懵逼，我这里给大家简单解释下，所谓带有副作用的参数就是指 putc('X', fp++) 这类型的参数，因为参数在宏的实现中可能会被调用多次，所以你的想法是 fp++，而副作用下产生的结果可能是 fp++++++。

**演示：**

```C
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
        FILE *fp;
        int ch;

if ((fp = fopen("file.txt", "w")) == NULL)
        {
                printf("打开文件失败！\n");
                exit(EXIT_FAILURE);
        }

for (ch = 33; ch <= 100; ch++)
        {
                fputc(ch, fp);
        }
        fputc('\n', fp);

fclose(fp);

return 0;
}
```

![](https://blog.fivk.cn/usr/uploads/2021/02/3103778379.png)

最后修改：2021 年 09 月 12 日