C++ 标准库的 C I/O 子集实现 C 风格流输入/输出操作。 <cstdio> 头文件提供通用文件支持并提供有窄和多字节字符输入/输出能力的函数,而 <cwchar>头文件提供有宽字符输入/输出能力的函数。
无格式输入/输出
从 stdin 读取字符
std::getchar
int getchar(); |
从 stdin 读取下个字符。
等价于 std::getc(stdin) 。
参数
(无)
返回值
成功时为获得的字符,失败时为 EOF 。
若文件尾条件导致失败,则另外设置 stdin 上的文件尾指示器(见 feof() )。若某个其他错误导致失败,则设置 stdin 上的错误指示器(见 ferror() )。
写字符到 stdout
std::putchar
int putchar( int ch ); |
写入字符 ch
到 stdout
。在内部,恰于写入前转换字符为 unsigned char 。
等价于 putc(ch, stdout) 。
参数
ch | - | 要写入的字符 |
返回值
成功时,返回被写入字符。
失败时,返回 EOF 并设置 stdout 上的错误指示器(见 ferror() )。
调用示例
#include <cstdio>
int main(void)
{
while (true)
{
char c = std::getchar();
std::putchar(c);
}
return 0;
}
输出
写字符串到 stdout
int puts( const char *str );
写入每个来自空终止字符串 str
的字符及附加换行符 '\n' 到输出流 stdout
,如同以重复执行 std::putc 写入。
不写入来自 str
的空终止字符。
参数
str | - | 要写入的字符串 |
返回值
成功时返回非负值
失败时,返回 EOF 并设置 stdout
的错误指示器(见 std::ferror() )。
注意
std::puts
函数后附一个换行字符到输出,而 std::fputs 不这么做。
不同的实现返回不同的非负数:一些返回最后写入的字符,一些返回写入的字符数(或若字符串长于 INT_MAX 则返回它),一些简单地返回非负常量。
在重定向 stdout 到文件时,导致 std::puts
失败的典型原因是用尽了文件系统的空间。
调用示例
#include <cstdio>
int main()
{
int rc = std::puts("Hello World");
if (rc == EOF)
{
std::perror("puts()"); // POSIX 要求设置 errno
}
return 0;
}
输出
把字符放回文件流
std::ungetc
int ungetc( int ch, std::FILE *stream ); |
若 ch
不等于 EOF ,则推入字符 ch
(转译为 unsigned char )到与流 stream
关联的输入缓冲区,方式满足从 stream
的后继读取操作将取得该字符。不修改与流关联的外部设备。
流重寻位操作 std::fseek 、 std::fsetpos 和 std::rewind 弃去 ungetc
的效果。
若调用 ungetc
多于一次,而无中间读取或重寻位,则可能失败(换言之,保证大小为 1 的回放缓冲区,但任何更大的缓冲区是实现定义的)。若成功进行多次 ungetc
,则读取操作以 ungetc
的逆序取得回放的字符。
若 ch
等于 EOF ,则操作失败而不影响流。
对 ungetc
的成功调用清除文件尾状态标志 std::feof 。
在二进制流上对 ungetc
的成功调用将流位置指示器减少一(若流位置指示器为零,则行为不确定)。
在文本流上对 ungetc
的成功调用以未指定方式修改流位置指示器,但保证在以读取操作取得所有回放字符后,流位置指示器等于其在 ungetc
之前的值。
参数
ch | - | 要推入输入流缓冲区的字符 |
stream | - | 要回放字符到的文件流 |
返回值
成功时返回 ch
。
失败时返回 EOF ,而给定的流保持不变。
注意
实践中,回放缓冲区的大小会在 4k ( Linux 、 MacOS )和 4 ( Solaris )或保证的最小值 1 ( HPUX 、 AIX )间变化。
若回放的字符等于存在于外部字符序列中该位置的字符,则回放缓冲区的表观大小可以更大(实现可以简单地自减读取的文件位置指示器,并避免维护回放缓冲区)。
调用示例
#include <cctype>
#include <cstdio>
void demo_scanf(const char* fmt, std::FILE* s)
{
if (*fmt == '%')
{
switch (*++fmt)
{
case 'u':
{
int c;
while (std::isspace(c = std::getc(s))) {} // 跳过前导空白
unsigned int num = 0;
while (std::isdigit(c))
{
num = num * 10 + c - '0';
c = std::getc(s);
}
std::printf("%%u scanned %u\n", num);
std::ungetc(c, s); // 重处理非数位
}
case 'c':
{
int c = std::getc(s);
std::printf("%%c scanned '%c'\n", c);
}
}
}
}
int main()
{
std::FILE* file = std::fopen("input.txt", "w+");
std::fputs("123x", file);
std::rewind(file);
demo_scanf("%u%c", file);
std::fclose(file);
return 0;
}