fclose、_fcloseall

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

fclose はストリームを閉じ、_fcloseall は開いているストリームをすべて閉じます。

int fclose( 
   FILE *stream 
);
int _fcloseall( void );

パラメータ

stream
FILE 構造体へのポインタ。

戻り値

ストリームが正常に閉じられた場合、fclose は 0 を返します。_fcloseall は、閉じられたストリームの総数を返します。いずれの関数も、エラーが発生したときは EOF を返します。

解説

fclose 関数は stream を閉じます。stream が NULL の場合は、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、fclose は EOF を返し、errno を EINVAL に設定します。この関数を呼び出す前に、必ず stream ポインタをチェックしてください。

エラーコードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。

_fcloseall は、stdin、stdout、stderr (MS-DOS では _stdaux と _stdprn) を除くすべての開いているストリームを閉じます。_fcloseall は、tmpfile で作成された一時ファイルもすべて閉じて削除します。いずれの関数もストリームに関連付けられているバッファをすべてフラッシュしてから、ストリームを閉じます。システムによって割り当てられたバッファは、ストリームを閉じるときに解放されます。ユーザーが setbuf および setvbuf によって割り当てたバッファは、自動的には解放されません。

メモ : これらの関数を使用してストリームを閉じる場合、ストリームと共に基になるファイル記述子とオペレーティングシステムのファイルハンドル (またはソケット) も閉じられます。したがって、ファイルハンドルまたはファイル記述子として開いたファイルを fclose を使用して閉じる場合、_close を呼び出してファイル記述子を閉じたり、Win32 CloseHandle 関数を呼び出してファイルハンドルを閉じたり、closesocket を呼び出してソケットを閉じたりしないでください。

fclose と _fcloseall には、他のスレッドのアクセスを抑止するためのコードが含まれます。fclose のロックしないバージョンについては、「_fclose_nolock」を参照してください。