stdio(3S)

構文

#include <stdio.h>

説明

このマニュアルのサブセクション (3S) で述べられている標準 I/O 関数は、ユーザーレベルの I/O バッファリング機構を構成するものです。 getc() 関数と putc() 関数は、文字を高速で処理します。 以下のすべての関数は、まるで getc() と putc() を使っているかのように使われるかまたは動作します。また、これらの関数は、自由に混合して使えます。

バッファリングを伴ったファイルは ストリーム と呼ばれ、定義済みのタイプである FILE へのポインタとして宣言されます。 fopen() は、ストリームに対する特定の記述データを作成し、それ以降のすべてのトランザクションでストリームを指定するポインタを返します。 章 (3S) のライブラリルーチンは、このストリーム上で動作します。

プログラムが始動すると、3 つのストリームである 標準入力、標準出力、標準エラーがあらかじめ定義され、それらのストリームをあらためて開く必要はありません。 ストリームが開くと、標準入力ストリームと標準出力ストリームに対して、出力の対象がファイルの場合にはバッファリングを行い、出力の対象が端末の場合には行バッファリングを行います。 標準エラー出力ストリームは、デフォルトではバッファリングが行われません。 これらの 3 つのストリームは、ヘッダファイル <stdio.h> の中に宣言されている以下の定数ポインタを持っています。

定数 NULL (0) は、存在しないポインタを指定します。

エンドオブファイルおよびエラー検出時には、ストリームを扱うほとんどの整数関数は、整数定数 EOF (-1) を返します (詳しくはそれぞれの関数の説明を参照)。

整数定数 BUFSIZ は、特定のインプリメンテーションが使うバッファのサイズを指定します ( setbuf(3S) を参照)。

このパッケージを使うどんなプログラムも、以下に示すように適切なマクロ定義を含んだヘッダファイルを含む必要があります。

このマニュアルのサブセクション (3S) で述べられている関数および定数は、このヘッダファイルで宣言されているので、それ以上の宣言は不要です。

定数 _NFILE は、プロセスごとに許されている開いているファイルのデフォルトの最大値を定義します。 このデフォルト値を越えて開いているファイルの範囲を拡げるには、 setrlimit(2) を参照してください。

警告

non-positional デバイスで、 stdio インタフェースを共有の読み書き可能ファイル記述子で使用すると、予期しない動作が生じることがあります。 non-positional devices 上で stdio 操作を行うアプリケーションは、2 つの種類の操作用に同じファイルポインタを使用する場合でも、操作の入出力の際には別々のファイルポインタを使用する必要があります。

エラー

不適切な ストリーム ポインタは、重大な混乱を引き起こし、プログラムを終了させてしまう場合もあります。 個々の関数の解説で、起こり得るエラー状態を述べています。

参照

close(2), lseek(2), open(2), pipe(2), read(2), getrlimit(2), write(2), ctermid(3S), cuserid(3S), fclose(3S), ferror(3S), fgetpos(3S), fileno(3S), fopen(3S), fread(3S), fseek(3S), fgetpos(3S), getc(3S), gets(3S), popen(3S), printf(3S), putc(3S), puts(3S), scanf(3S), setbuf(3S), system(3S), tmpfile(3S), tmpnam(3S), ungetc(3S)

標準準拠

stderr: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

stdin: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

stdout: AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C