5.7 fgets/fputs和gets/puts-流的单行读写

fgets/fputs、gets/puts是两对用于流的单行读写函数。

函数原型：

#include <stdio.h>
char *fputs(char *restrict buf, int n, FILE *restrict fp);
char *gets(char *buf);

返回值：若成功则返回buf，若已到达文件结尾或者出错则返回 NULL

参数：

buf 为存放取出字符的缓冲区地址

n 为缓冲区大小

fp 文件指针

#include <stdio.h>
int fputs(const char *restrict str, FILE *restrict fp);
int puts(const char *str);

返回值：若成功则返回非负值，若出错则返回 EOF

参数：

str 为存放输出字符的缓冲区地址

fp 文件指针

实例 x.5.7.1.c

#include <stdio.h>

#define LINELEN 5
int main(void)
{
    char      pathname[] = "/tmp/myfile";
    FILE      *fp;
    char      str[LINELEN];

    if ((fp=fopen(pathname, "r")) == NULL) {  /*为读打开流*/
        printf("fopen error for %s\n", pathname);
    } else {
        fgets(str, LINELEN, fp); /*从流中读取一行*/
        printf("%s\n", str);
        fclose(fp); /*关闭流*/
    }

    return 0;
}

编译与执行：

[root@localhost unixc]# echo "123456789" > /tmp/myfile
[root@localhost unixc]# cat /tmp/myfile
123456789
[root@localhost unixc]# cc x.5.7.1.c
[root@localhost unixc]# ./a.out
1234
[root@localhost unixc]#

分析：实例中虽然文件有9个字符，但是给定的缓冲区长度是5，扣除最后一个null结尾字符，只能取到4个字符。

实例 x.5.7.2.c

#include <stdio.h>

#define LINELEN 5
int main(void)
{
    char      pathname[] = "/tmp/myfile";
    FILE      *fp;
    char      str[LINELEN];

    if ((fp=fopen(pathname, "w")) == NULL) {  /*为写打开流，并将文件截短为0*/
        printf("fopen error for %s\n", pathname);
    } else {
        fgets(str, LINELEN, stdin); /*从标准输入中读取一行*/
        fputs(str, fp);/*将取得字符写入文件流*/
        fflush(fp); /*冲刷流*/
        fclose(fp); /*关闭流*/
    }

    return 0;
}

编译与执行：

[root@localhost unixc]# echo "abcdefghij" > /tmp/myfile
[root@localhost unixc]# cat /tmp/myfile
abcdefghij
[root@localhost unixc]# cc x.5.7.2.c
[root@localhost unixc]# ./a.out
123456789
[root@localhost unixc]# cat /tmp/myfile
1234[root@localhost unixc]#

分析：实例中尽管输入了9个数字，但是由于给定的缓冲区长度为5，扣除一个null结束标志，只能取到4个数字。

两个例子说明，更多时候应当选择使用fgets/fputs，因为这对输入输出有明确的缓冲区长度限制，从而避免缓冲区溢出导致不可预测的错误。