Manpages

STDIN(3) BSD Library Functions Manual STDIN(3)

NAME

stdin, stdout, stderr — 标 准 I/O 流

SYNOPSIS 总 览

#include <stdio.h>
extern FILE *stdin;
extern FILE *stdout;
extern FILE *stderr;

DESCRIPTION 描 述 通 常 , 每 个 Unix 程 序 在 启 动 时 都 会 打 开 三 个 流 , 一 个 用 于 输 入 , 一 个 用 于 输 出 , 一 个 用 于 打 印 诊 断 或 错 误 消 息 。 典 型 的 , 他 们 被 连 接 到 用 户 的 终 端 (参 见 tty(4)) 但 是 也 有 可 能 指 向 文 件 或 是 其 他 设 备 , 取 决 于 父 进 程 选 择 设 置 了 什 么 (参 见 sh(1) 的 重 定 向 (’’Redirection’’) 章 节 。 ) 输 入 流 被 称 为 ’’standard input’’; 输 出 流 被 称 为 ’’standard output’’; 错 误 流 被 称 为 ’’standard error’’。 这 些 名 词 通 常 简 写 为 符 号 , 用 于 引 用 这 些 文 件 , 它 们 是 stdin, stdout, 和 stderr. 这 些 符 号 中 , 每 一 个 都 是 stdio(3) 中 的 一 个 宏 , 类 型 是 指 向 FILE 的 指 针 , 可 以 用 于 类 似 fprintf(3)fread(3) 等 函 数 中 。 由 于 FILE 是 一 个 对 Unix 文 件 描 述 符 加 以 缓 冲 的 包 装 , 下 层 的 文 件 也 可 以 使 用 原 始 的 Unix 文 件 接 口 来 存 取 。 也 就 是 , 类 似 read(2)lseek(2) 的 函 数 。 与 流 stdin, stdout, 和 stderr 关 联 的 整 数 形 式 的 文 件 描 述 符 分 别 是 0, 1 还 有 2。 预 处 理 器 符 号 STDIN_FILENO, STDOUT_FILENO 和 STDERR_FILENO 分 别 以 它 们 为 值 , 定 义 在 <unistd.h> 中 。 注 意 混 合 使 用 FILE 和 原 始 的 文 件 描 述 符 可 能 带 来 不 可 预 料 的 结 果 , 一 般 应 当 避 免 。 (对 于 喜 欢 追 根 问 底 的 人 : POSIX.1 规 范 的 8.2.3 节 详 细 地 描 述 了 这 样 的 混 合 使 用 怎 样 才 能 不 出 错 。 ) 一 个 简 单 的 规 则 是 , 文 件 描 述 符 由 内 核 控 制 , 而 stdio 仅 仅 是 一 个 库 。 它 的 意 思 是 , 例 如 当 调 用 exec 之 后 , 子 进 程 可 以 继 承 所 有 打 开 的 文 件 描 述 符 , 但 是 任 何 原 有 的 流 都 不 可 再 存 取 了 。 由 于 符 号 stdin, stdout, 和 stderr 被 指 定 为 宏 , 为 它 们 赋 值 将 导 致 不 可 移 植 。 利 用 库 函 数 freopen(3) , 标 准 流 可 以 用 来 指 向 不 同 的 文 件 。 引 进 这 个 函 数 专 门 用 来 为 stdin, stdout, 和 stderr 重 新 赋 值 。 标 准 流 在 调 用 exit(3) 和 程 序 正 常 中 止 时 被 关 闭 。

SEE ALSO 参 见

sh(1), csh(1), open(2), fopen(3), stdio(3)

CONSIDERATIONS 错 误 流 stderr 是 非 缓 冲 的 。 输 出 流 stdout 是 行 缓 冲 的 , 如 果 它 指 向 一 个 终 端 。 不 完 全 的 行 只 有 在 调 用 fflush(3)exit(3) , 或 者 打 印 了 新 行 符 之 后 才 会 显 示 。 这 样 可 能 带 来 无 法 预 料 的 结 果 , 尤 其 是 调 试 输 出 时 。 标 准 流 (或 任 何 其 他 流 ) 的 缓 冲 模 式 可 以 用 函 数 setbuf(3)setvbuf(3) 来 切 换 。 注 意 当 stdin 与 一 个 终 端 关 联 时 , 也 许 终 端 驱 动 中 存 在 输 入 缓 冲 , 与 stdio 缓 冲 完 全 无 关 。 (确 实 如 此 , 一 般 的 终 端 输 入 在 内 核 中 是 行 缓 冲 的 。 ) 内 核 对 输 入 的 控 制 可 以 通 过 对 tcsetattr(3) 的 调 用 来 修 改 , 参 见 stty(1), 和 termios(3)

CONFORMING TO 标 准 参 考stdin, stdout, 和 stderr 遵 循 ANSI X3.159-1989 (’’ANSI C89’’) 标 准 , 这 个 标 准 同 时 规 定 了 这 三 个 流 应 当 在 程 序 启 动 时 打 开 。 本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 : https://github.com/man-pages-zh/manpages-zh

Linux 2.0 March 24, 1998 Linux 2.0

COMMENTS