stdin

Section: C Library Functions (3)
Updated: 2025-09-21
Index JM Home Page roff page
 

名前

stdin, stdout, stderr - 標準入出力ストリーム  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <stdio.h>

extern~FILE~~*stdin;
extern~FILE~~*stdout;
extern~FILE~~*stderr;
 

説明

Under normal circumstances every UNIX program has three streams opened for it when it starts up, one for input, one for output, and one for printing diagnostic or error messages. These are typically attached to the user's terminal (see tty(4)) but might instead refer to files or other devices, depending on what the parent process chose to set up. (See also the "Redirections" section of sh(1).)

入力ストリームは "standard input" と呼ばれる。出力ストリームは "standard output"、エラーストリームは "standard error" と呼ばれる。 これらの用語を短縮したものがそれぞれのファイルを示すシンボルとなる。つ まり stdin, stdout, stderr である。

これらのシンボルは stdio(3) のマクロで、 FILE へのポインター型である。したがって fprintf(3) や fread(3) などの関数とともに用いることができる。

FILE は UNIX のファイルディスクリプターにバッファー機能を追加したラッパー であるから、これらのマクロにも対応するファイルがあり、 UNIX の raw ファ イルインターフェース (read(2) や lseek(2) など) によってアクセスすることもできる。

プログラムの起動時には、 ストリーム stdin, stdout, stderr に結びつけられているファイルディスクリプターの番号は、 それぞれ 0, 1, 2 である。 プリプロセッサシンボル STDIN_FILENO, STDOUT_FILENO, STDERR_FILENO は <unistd.h> 中でそれぞれこれらの値に定義されている。 (これらのストリームに対して freopen(3) を適用することで、そのストリームに関連付けられたファイルディスクリプター の番号を変更することができる。)

FILE と raw なファイルディスクリプターの併用は、予期できない結果を生じ ることがあるので、通常は避けるべきである。 (マゾヒスティックな人に: POSIX.1 のセクション 8.2.3 には、この混用で動作がどのようになりそう かが詳しく記述されている。) 一般的なルールは以下の通り: ファイルディスクリプターはカーネルによって 扱われ、 stdio は単にライブラリによって扱われるのである。すなわち例えば exec(3) の後には、子プロセスはオープンされているファイルディスクリプター をすべて継承するが、親からのストリームはすべてアクセス不可となる。

シンボル stdin, stdout, stderr はすべてマクロとして定義されているので、これらへの代入 は移植性を保証されない。標準ストリームはライブラリ関数 freopen(3) を用いれば、別のファイルを示すように変更することもできる。 このライブラリ関数は stdin, stdout, stderr の再割り当てが可能なように特別に導入されたものである。 標準ストリームは exit(3) の呼び出しと、プログラムの正常終了によってクローズされる。  

標準規格

C11, POSIX.1-2008.

The standards also stipulate that these three streams shall be open at program startup.  

歴史

C89, POSIX.1-2001.  

注意

stderr ストリームはバッファーリングされていない。 stdout ストリームは、端末に接続されているときには行単位でバッファーリング されている。一行に満たない内容は、 fflush(3) か exit(3) が呼び出されるか、改行文字が印字されるまで表示されない。これは、 特にデバッグ時において、予期しない結果を生じる原因となるかもしれない。 標準ストリームの (あるいは他のすべてのストリームの) バッファーリングモードは、 setbuf(3) または setvbuf(3) を呼び出すことによって変更できる。 ただし、 stdin が端末に接続されているときは、端末のドライバでバッファーリングされている 可能性がある点にも注意すること。これは stdio のバッファーリングとは全く 関係なく存在しうる。 (実際、通常だと端末入力はカーネルによって行単位 でバッファーリングされている。) このカーネルによる入力の扱いは tcsetattr(3) などの呼び出しによって変更することができる。 stty(1) と termios(3) も参照すること。  

関連項目

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


 

Index

名前
ライブラリ
書式
説明
標準規格
歴史
注意
関連項目

This document was created by man2html, using the manual pages.