s_gets()函数解析

        在学习《C primer plus》时，有一个获取输入的函数s_gets()出现频率非常高，此处记录下对这个函数的理解，该函数首次出现于程序清单11.10。

函数源代码：

char *s_gets(char *st, int n)  
{  
    char *ret_val;  
    char *find;  
    ret_val = fgets(st, n, stdin);  
    if(ret_val)  
    {  
        find = strchr(st, '\n');  
        if(find)  
        {  
            *find = '\0';  
        }  
        else  
        {  
            while(getchar() != '\n')  
                continue;  
        }  
    }  
    return ret_val;  
}  

测试代码：

#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>
#include <errno.h>

int main(int argc, char *argv[])
{
    char test[10] = {0};
    while(1)
    {
        s_gets(test, 10);
        printf("output: %s \n", test);
    }

    return 0;
}

函数解析：

（1）fgets()

/**
 * @brief fgets()函数获取一整行输入：
 *          读取输入直达换行符（换行符也被读取），或者读到文件结尾，或者读取(n-1)个字符
 *          读取完成后，再在读取内容末尾添加空字符'\0'，使读取内容成为一个字符串
 * @param str 指向一个字符数组，该数组存储了要读取的字符串。
 * @param n 这是要读取的最大字符数
 * @param stream FILE*指针，指明要读入的文件，如果是键盘输入，则以stdin（标准输入）作为参数
 * @return char* 如果返回成功，则返回值与char* str参数相同，如果到达文件末尾或者没有读取到任何字符，str 的内容保持不变，并返回一个空指针
 *               如果发生错误，返回一个空指针。
 */
char *fgets(char *str, int n, FILE *stream)

        可以发现fgets()的限制条件可以分为两类，字符串长度（包括回车'\n'）大于（n-1），则读取（n-1）的长度，并在末尾加上空字符'\0'，如果字符串长度（包括回车'\n'）小于（n-1），则表示fgets获取了“一整行”，将字符串（包括回车'\n'）读取至char* str中。

（2）strchr()

/**
 * @brief strchr()函数寻找参数 str 所指向的字符串中搜索第一次出现字符 c（一个无符号字符）的位置
 * 
 * @param str 
 * @param c 
 * @return char* 该函数返回在字符串 str 中第一次出现字符 c 的位置，如果未找到该字符则返回 NULL
 */
char *strchr(const char *str, int c)

        获取输入字符串st后，寻找st中是否有 '\n' 字符，如果有，则替换为 '\0' 字符，使st成为一个字符串。这实际上对应的情况就是键盘输入的字符串长度（包括'\n'）小于或者等于（n-1）的情况，这样 '\n' 字符才会存在于st中。

（3）

        else中对应的情况是键盘输入的字符串长度大于（n-1），那么st存储了（n-1）个字符后，再加上1个 '\0' ，成为字符串。此时在输入输出缓冲区中，还存在着没被st存储的剩余的字符，如果不处理这些字符，那么在主程序的下一次读取中，会从缓冲区读取这些剩余字符。

        else
        {
            while(getchar() != '\n')
                continue;
        }

        做个实验，如果将s_gets()函数中的的else{}部分注释掉，输入超过10个字符，比如1234567890abcdefg。那么结果如下，可以发现输出了两次：

        注释掉else{}部分的话，会发现输出了两次，取消注释，再次编译运行的话，只会输出一次。在while()循环中，getchar()每次从输入缓冲区取出一个字符，直至取到 '\n' 换行符，此时缓冲区的剩余字符就全部取出了（包括 '\n'） ，这样就不会影响下一次s_gets()获取键盘输入了。

（4）补充

        输入输出缓冲区是在内存中开辟的一块空间，键盘输入是发送到输入缓冲区，程序再从缓冲区取数据的。缓冲区在代码中是没有具体体现的，需要脑内有缓冲区这个模型。

为什么需要缓冲区：

详解getchar()函数与缓冲区_学无止境-CSDN博客_getchar缓冲区

举个例子，我们知道计算机CPU的处理速度很快的，而我们键盘的输入速度总是比不过CPU的处理速度，那么CPU就得一直等着键盘输入完，这样很浪费资源。于是，我们党键盘输入完了，再让CPU一次性处理，这样就会大大地提高效率。

又比如，我们的打印机打印文档，打印机的处理速度是很慢的，所以我们会将文档输出到打印机的缓存中去，这样打印机就可以自行慢慢打印，而不必占用CPU资源。

有时候程序中使用了sleep()，此时使用printf()等输出函数可能会没有即时输出，要等程序运行结束后才输出，有可能是输出缓冲区的问题：

printf()函数缓存区刷新问题_h___q的博客-CSDN博客_printf刷新输出

解决方法有两种，一种是强制刷新流，另一种是设置输出缓冲区大小为0：

fflush(stdout); //强制刷新流
setvbuf(stdout,NULL,_IONBF,0); //设置输出缓冲区为0