1 函数原型

gets()：从标准输入流stdin读取一个字符串存储到str指向的内存空间，函数原型如下：

char *gets(char *str)

2 参数

gets()函数的参数只有一个str：

1. str是一个指向char类型的指针，即str可以是一个字符指针变量名，也可以是一个字符数组名。

3 返回值

gets()函数的返回值类型是一个指向char类型的指针：

1. 读取成功，返回str；
2. 读取失败，返回NULL。

C语言标准描述如下：

1. Each of these functions returns its argument if successful. 
2. A NULL pointer indicates an error or end-of-file condition. 

4 读取机制

gets()从标准输入流stdin中读取字符，直至遇到换行符’\n’：

1. 接受换行符之前的所有字符，包括空格、制表符等字符；
2. 将换行符’\n’替换为空字符’\0’，作为字符串结束符；
3. 将字符串储存在str指向的内存空间里。

注意事项：

1. 如果从标准输入流stdin中读取的第一个字符就是换行符’\n’，则str指向的字符串是个空字符串，即只包含空字符’\0’的字符串；
2. 在调用gets()函数之前，必须分配足够的内存空间来储存str指向的字符串;
3. gets()函数存在一个重大缺陷：gets()函数会读空标准输入流stdin，因此无法预知从标准输入流stdin中读取的字符串的长度；gets()函数不检查str指向的内存空间是否能够容纳从标准输入流stdin中读取的字符串，因此存在内存访问越界的隐患。

5 示例

示例代码如下所示：

void clear_stdin(void)
{
   while (getchar() != '\n');
}

int main()
{
   //定义变量
   char str[80] = { 0 };
   char ch;
   //输入字符串：2个空格+abc+Tab+def+2个空格回车
   gets(str);
   //输出字符串
   puts(str);
   //输出字符串长度
   printf("%d\n", strlen(str));
   //检查stdin是否为空，若为空则输入字符'c'并打印
   ch = getchar();
   clear_stdin();
   putchar(ch);
   //
   printf("\n");

   return 0;
}

运行结果如下图所示：

分析程序及运行结果：

1. gets()函数读取了标准输入流stdin中回车符’\n’之前的所有字符，即4个空格+6个英文字母+1个制表符=11个字符，与strlen统计结果相符；
2. 在调用gets()函数之后，再次调用getchar()函数，控制台提示用户输入字符，说明gets()函数已将标准输入流stdin中读空（包括换行符）。