简记C语言清空输入残留内容

为了在命令行程序中实现和用户的交互，我们编写的程序的运行过程中往往涉及到对标准输入/输出流的多次读写。

在C语言中接受用户输入这一块，有着一个老生常谈的问题：“怎么样及时清空输入流中的数据？”

这也是这篇小笔记的主题内容。

先从缓冲区说起。

缓冲区是内存中划分出来的一部分。通常来说，缓冲区类型有三种：

• 全缓冲
• 行缓冲
• 无缓冲

行缓冲

在C语言中缓冲区这个概念的存在感还是挺强的，比较常用到的缓冲区类型则是行缓冲了，如标准输入流 stdin 和标准输出流 stdout一般（终端环境下）就是在行缓冲模式下的。

行缓冲，顾名思义，就是针对该缓冲区的I/O操作是基于行的。

• 在遇到换行符前，程序的输入和输出都会先被暂存到流对应的缓冲区中

• 而在遇到换行符后（或者缓冲区满了），程序才会进行真正的I/O操作，将该缓冲区中的数据写到对应的流 (stream) 中以供后续读取。

就标准输入stdin而言，用户的输入首先会被存到相应的输入缓冲区中，每当用户按下回车键输入一个换行符，程序才会进行I/O操作，将缓冲区暂存的数据写入到stdin中，以供输入函数使用。

而对标准输出stdout来说，输出内容也首先会被暂存到相应的输出缓冲区中，每当输出数据遇到换行符时，程序才会将缓冲区中的数据写入stdout，继而打印到屏幕上。

这个例子可以修改成这样：

#include 
int main()
{
	// 设置缓冲模式为行缓冲，缓冲区大小为10字节
	setvbuf(stdout, NULL, _IOLBF, 10);
	fprintf(stdout, "1234567"); // 这里先向stdout对应的缓冲区中写入了7字节
	fflush(stdout); // 刷新缓冲区，将缓冲区中的数据写入到标准输出流中
	getchar(); // 这里等待用户输入
	printf("89"); // 再向stdout对应的缓冲区中写入了2字节
	fflush(stdout); 
	getchar(); // 接着等待用户输入
	printf("Print!"); // 再向stdout对应的缓冲区中写入了6字节
	getchar(); // 最后再等待一次用户输入
	return 0;
}

运行效果：

可以看到，加入fflush(stdout)后，输出缓冲区的内容会被及时写入stdout中，继而打印到屏幕上。

值得注意的是，fflush(stdin)的行为是未定义（不确定）的：

For input streams (and for update streams on which the last operation was input), the behavior is undefined.

不同平台的编译器对此有不同的解释。

• 比如在Windows平台上，无论是VC6.0这种目前一些学校教学还在使用的古董编译器，还是gcc 8.x.x，大体还是支持通过这种操作清空输入流的。

• 但是在Linux平台上的gcc编译器就不买账了，是不支持fflush(stdin)这种操作的。

因此，尽量避免fflush(stdin)这种写法，这十分不利于代码的可移植性。

标准输入流stdin

上面提到因为可移植性要避免fflush(stdin)这种写法，接下来记录一下可移植性高的写法。

接受格式化输入时去除多余空白符

这一种其实用的比较少，但我觉得还是得记一下。

whitespace characters: any single whitespace character in the format string consumes all available consecutive whitespace characters from the input. Note that there is no difference between "\n", " ", "\t\t", or other whitespace in the format string.

上面这段解释来自于cppreference，也就是说，格式化字符串中的空白符（如"\n", " ", "\t\t"）会吸收输入字符串中的一段连续的空白符。

也就是说，下面这句格式化输入函数：

scanf(" %c %c",&recvChar1,&recvChar2);

可以从stdin中读取形如 \n a b， \t a b这样的数据。其中a之前的空白符和a与b之间的空白符都会被吸收，scanf得以能准确获取字符a和b。

依靠这个特性，我们可以在接收输入时自动剔除stdin中残留的空白符：

// 因为格式%s不会匹配多余的空白符，这里按回车后，stdin中会残留一个换行符\n
scanf("%s",recvStr);
// 在格式%c前加一个空格，可以吸收掉上面残留的换行符\n，程序便能如预期接受用户输入
scanf(" %c",&recvChar);

然而，这一种方法仅只能剔除多余的空白符。

使用中括号字符集

这个解决方法可以和上面剔除空白符的方法进行结合。

格式化输入有一个说明符 %[set]，它的功能和正则表达式中的中括号[ ]十分类似：

• 其中set代表一个用于匹配的字符集，一般情况下匹配的是存在字符集中的字符

• 字符集的第一个字符如果是^，则表示取反，匹配的是不存在于该字符集中的字符

• 可以在中括号中使用短横线 - 来表达一个范围，比如%[0-9]代表匹配0-9之间的字符。值得注意的是，对于短横线-，可能在不同编译器之间有不同实现，它是implementation-defined的。

另还有一个说明符 * ，它被称为赋值抑制或赋值屏蔽符。如字面意思，在%引导的格式转换字串中如果包含*，这个格式匹配的内容不会被赋给任何变量。

于是，可以给出如下的语句：

// 星号 * 代表不会把匹配到的内容赋给变量，相当于“吸收”掉了
// [^\n] 代表除了换行符外一律匹配
scanf("%*[^\n]");

因为用户结束一次输入的标志通常是按回车输入一个换行符，残留的内容往往末尾是一个换行符。上面这句的原理就是吸收掉stdin中所有的残余字符，直至达到最后一个字符，也就是换行符。

然而，换行符不会被上面这句所吸收，所以在接下来的输入中只需要忽略stdin中的残余空白符即可（换行符就是空白符之一）：

scanf("%*[^\n]");
scanf(" %c",&recvChar);

这种方法已经可以解决一般情况下的输入残余问题，不过在后续接受格式化输入时还得忽略换行符\n，还是有点麻烦。

循环取走残余字符

这一种方法能在清除残余时顺便吸收掉末尾的换行符\n。

取字符需要用到取单个字符的输入函数，这里为了方便，选用的是getchar()。

一般情况下可以这样写：

// getchar() 会从 stdin 中取走一个字符
while(getchar() != '\n')
	;

（使用前提：stdin中有残余）

while循环会一直进行，直至getchar()取到的字符为换行符\n为止，这样就可以顺带吸收掉末尾的换行符了，能相对完美地清除掉stdin中的残余内容。
（在行缓冲模式下，用户的一次输入通常以一个换行符结束）

不过咧，还可以考虑更周全点。在getchar()获取字符失败的时候会返回EOF，但此时并不满足while循环的退出条件，对此可以再完善一下：

// 临时储存字符
// 之所以是整型(int)，是因为EOF是一个代表 负值整型（通常为-1） 的宏
int tempChar;
// tempChar=getchar()这种赋值语句本身的返回值就是所赋的值
while ((tempChar = getchar()) != '\n' && tempChar != EOF)
	;

这样一来，当getchar()失败时，程序执行就会跳出循环。

综上，针对stdin中的残余内容的清除，最建议采用的便是最后这种处理方法。

不过其他的方法也是可以在一些场景中使用的，这就见仁见智了...

什么时候会返回EOF

这里提一个题外的点：什么时候getchar()会返回EOF？再进一步想，什么时候程序会认为标准流stdin达到了文件流末尾？

实际上，这里的EOF往往是用户输入的一个特殊二进制值^[3]，输入方式：

• 在Windows系统下是 Ctrl + Z（F6应该也行）

• 在Linux下是 Ctrl + D

当用户在输入中发送EOF时，标准流stdin就会被标记为EOF，因此getchar()就会获取字符失败而返回EOF。

// 测试用代码
#include 
int main()
{
	char testChar;
	fprintf(stdout, "Input Char: \n");
	testChar = getchar();
	if (testChar == EOF)
	{
		printf("Received EOF\n");
	}
	else
	{
		printf("Received a char\n");
	}
	return 0;
}

EOF在C语言中是一个宏，定义在头文件stdio.h中，其值为一个负值的整型（并不一定是 -1），因此上面用tempChar != EOF来判断getchar()失败。

处理残余的语句放在哪里

现在咱已经搞清楚了清除残余的代码，那么这些代码该放在哪呢？

对于标准输出流stdout来说，fflush语句往往放在输出函数执行完成之后，以立刻将输出内容打印到屏幕上：

printf("Hello ");
printf("World!\n");
fflush(stdout);

当然，如果嫌麻烦可以在输出前直接通过setbuf关闭stdout的缓冲：

setbuf(stdout, NULL);

对于标准输入流stdin来说，处理残余的语句往往放在每次输入函数执行之后，以及时清理流中残余内容：

int c;
char testChar1, testChar2;
scanf("%*s"); // * 用于屏蔽赋值
while ((c = getchar()) != '\n' && c != EOF)
	;
testChar1 = getchar();
while ((c = getchar()) != '\n' && c != EOF)
	;
scanf("%c", &testChar2);

当然，这样就显得有点冗余了。

实际上可以将清除的语句封装进函数或者定义为宏（不过确实不太建议定义为宏），这样也更便于维护。

总结

之前浏览了很多相关文章，标题和内容大多都写着“清空输入缓冲区”。现在想一下，这样写可能是不对的，因为实际我清空的是标准输入流stdin中的残留内容。在用户输入完成（输入换行符）的那一刻，输入缓冲区实际上就已经被清空了。

也就是说，标准流和对应的缓冲区要辨别清楚，二者不是同一个概念（一个stream一个buffer），千万不能混淆了。

最后，感谢你看到这里~
本笔记可能还是有错误出现，也请各位多指教！

参考文献

本笔记相关：

1. File input/output - cppreference.com

2. Clarify the difference between input/output stream and input/output buffer - StackOverflow

3. End of File in stdin - StackOverflow

关于"implementation-defined"

• Undefined, unspecified and implementation-defined behavior - StackOverflow