Provided by:
manpages-ja-dev_0.5.0.0.20070415-1_all 
前
fopen, fdopen, freopen - ストリームを開く関数
式
#include <stdio.h>
FILE *fopen(const char *path, const char *mode);
FILE *fdopen(int fildes, const char *mode);
FILE *freopen(const char *path, const char *mode, FILE *stream);
明
fopen() 関数は、 path で指定された名前のファイルを開-
、ストリームと結びつける。
引数 mode は、以下に続く文字のひとつから始まる文字列へのポインタである
(追加の文字がこの文字の後に続くこともある):
r テゥ好肇侫．ぅ襪鯑匹濬个垢燭瓩乏く。
ストリームはファイルの先頭に位置される。
r+ 読み出しおよび書すみするために開く。
ストリームはファイルの先頭に位置される。
w ファイルを書すみのために開く。
ファイルが既に存在する場合には長さゼロに切り詰める。
ファイルがなかった場合には新たに作成する。
ストリームはファイルの先頭に位置される。
w+ 読み出しおよび書すみのために開く。
ファイルが存在していない場合には新たに作成する。
存在している場合には長さゼロに切り詰められる。
ストリームはファイルの先頭に位置される。
a 追加 (ファイルの最後に書すむ) のために開く。
ファイルが存在していない場合には新たに作成する。
ストリームはファイルの最後に位置される。
a+ 読み出しおよび追加 (ファイルの最後に書すむ) のために開く。
ファイルが存在していない場合には新たに作成する。
読み出しの初期ファイル位置はファイルの先頭であるが、 書-
込みは常にファイルの最後に追加される。
mode 文字列には文字 ``b'' を追加指定することがでぁ mode
文字列の最後の文字として指定する。 上気里Δ 2 文字のモードの場合には 2
つの文字の間に指定することもでい襦 これは C89 との互換-
のためだけに用意された
ものであり、関数の実行に対してはいかなる影響も持たない。
すなわち、Linux を含む全ての POSIX 準拠システムでは、 この ``b''
は無視される。 (その他のシステムではテ-
ストファイルとバイナリファイルを別々に扱うものもあるので、
もしバイナリファイルの入出力を行い、 そのプログラムが非 UNIX 環-
へ移植されると予測するなら、 ``b''を付けておくのは良い考えである)
すべての生成されたファイルは、
S_IRUSR|S_IWUSR|S_IRGRP|S_IWGRP|S_IROTH|S_IWOTH (0666) のモードを
そのプロセスの umask 値によって修正したモードを持つ (umask(2) を見よ)。
読み出し/書すみストリームに対しては任意の順序で読み書い鮃圓Δ海箸で-
る。 ただし ANSI C では、
(入力操作がファイルの末尾に到達した場合を除いて)
出力と入力の間にはファイルの位置決め関数を
挟まなければならないことになっていることに注意されたい (この条件を満-
しない場合には、読み込み操作は、 最後に書-
込まれたものでなく、以前に書すまれた 値を返すことを許されている)。
したがって、このようなストリームでの読み書ち犧遒隆屬砲 fseek() または
fgetpos() 操作を挟んでおくと良いだろう (Linux
では本当に必要となることもとい匹ある)。
この操作は見かけ上何もしない操作 (no-op) でも良い (例えば fseek(...,
0L, SEEK_CUR) を その副次的効果である同期のためだけに呼べば良い)。
ファイルを追加モード (mode の最初の文字をaにする) で開くと、
このストリームに対する書すみ操作は (先に
fseek(stream,0,SEEK_END);
呼び出しを実行したかのように) ファイル末尾に対して行われる。
fdopen() 関数は、既存のファイル欺匯 fildes にストリームを結びつける。
ストリームの mode ("r", "r+", "w", "w+", "a", "a+" のいずれか) は
ファイル欺匯劼離癲璽匹噺澳垢里發里任覆韻譴个覆蕕覆ぁ
新しいストリームのファイル位置指示子は fildes
に属している値に設定される。 error と end-of-file
の各指示子はクリアされる。 "w" および "w+"
モードでのファイルの切り詰めは行われない。 ファイル-
述子の複製は行なわれない。 fdopen()
で作成されたストリームが閉じられたとい縫侫．ぅ覽述子も 閉じられる。
共優瓮皀蠅離ブジェクトへ fdopen() を行ったと-
の結果は定義されていない。
freopen() 関数は path で名前が指定されたファイルを開ぁ stream
で指定されたストリームに、そのファイルを結びつける。 もとのストリームは
(もし存在する場合には) 閉じられる。 mode 引数は fopen()
関数と同じ形で使われる。 freopen() 関数の主な用途は、標準テ-
ストストリーム (stderr、stdin、stdout)
と対応付けられているファイルを変更することである。
値
fopen(), fdopen(), freopen() は成功すると FILE 型のポインタを返す。
失敗すると NULL が返され、大域変数 errno
がエラーを示す値にセットされる。
ー
EINVAL fopen(), fdopen(), freopen() で与えられた mode が不適切である。
fopen(), fdopen(), freopen() 関数は malloc(3)
ルーチンで規定されているエラーでも失敗することがあり、
その時は対応する値に errno をセットする。
fopen() 関数は open(2)
ルーチンで規定されているエラーでも失敗することがあり、
その時は対応する値に errno をセットする。
fdopen() 関数は fcntl(2)
ルーチンで規定されているエラーでも失敗することがあり、
その時は対応する値に errno をセットする。
freopen() 関数は open(2), fclose(3), fflush(3)
各ルーチンで規定されているエラーでも失敗することがあり、
その時は対応する値に errno をセットする。
拠
fopen() 関数と freopen() 関数は C89に準拠している。 fdopen() 関数は
POSIX.1-1990 に準拠している。
glibc 張
GNU C ライブラリでは、 mode に指定で-
る文字列として、以下の拡張が行われている:
c (glibc 2.3.3 以降)
open 操作、それに続く read/write 操作の、 スレッドの-
ャンセレーションポイント (cancellation points) を作成しない。
m (glibc 2.3 以降)
I/O システムコール (read(2), write(2)) ではなく、 mmap(2)
を使ってファイルにアクセスしようとする。 mmap(2)
を使おうとするのは、読み出し用にオープンするファイルについてだけである。
x ファイルを排他的にオープンする (open(2) の O_EXCL
フラグと同様)。 ファイルがすでに存在する場合、 fopen()
は失敗し、 errno に EEXIST がセットされる。 このフラグは
fdopen() では無視される。
open(2), fclose(3), fileno(3)