fflushfflush

ストリームをフラッシュします。Flushes a stream.

構文Syntax

int fflush(
   FILE *stream
);

パラメーターParameters

一連stream
FILE 構造体へのポインター。Pointer to FILE structure.

戻り値Return Value

fflushは、バッファーが正常にフラッシュされた場合に0を返します。fflush returns 0 if the buffer was successfully flushed. 指定したストリームにバッファーがないか、読み取り専用で開かれる場合にも、値 0 が返されます。The value 0 is also returned in cases in which the specified stream has no buffer or is open for reading only. EOFの戻り値はエラーを示します。A return value of EOF indicates an error.

注意

FflushEOFを返す場合、書き込みエラーによってデータが失われている可能性があります。If fflush returns EOF, data may have been lost due to a write failure. 重大なエラーハンドラーを設定するときは、 setvbuf関数を使用してバッファリングをオフにするか、ストリーム i/o 関数の代わりに、 _open_close_writeなどの低レベルの i/o ルーチンを使用することをお勧めします。When setting up a critical error handler, it is safest to turn buffering off with the setvbuf function or to use low-level I/O routines such as _open, _close, and _write instead of the stream I/O functions.

RemarksRemarks

Fflush関数は、ストリームストリームをフラッシュします。The fflush function flushes the stream stream. 書き込みモードでストリームを開いた場合、または更新モードで開き、最後の操作が書き込みだった場合、基になるファイルまたはデバイスにストリーム バッファーの内容が書き込まれ、バッファーは破棄されます。If the stream was opened in write mode, or it was opened in update mode and the last operation was a write, the contents of the stream buffer are written to the underlying file or device and the buffer is discarded. ストリームが読み取りモードで開かれた場合、またはストリームにバッファーがない場合、 fflushを呼び出すと無効になり、すべてのバッファーが保持されます。If the stream was opened in read mode, or if the stream has no buffer, the call to fflush has no effect, and any buffer is retained. Fflushを呼び出すと、ストリームのungetcに対する以前の呼び出しの効果が否定されます。A call to fflush negates the effect of any prior call to ungetc for the stream. 呼び出し後もストリームは開いたままになります。The stream remains open after the call.

ストリームNULLの場合、動作は、開いている各ストリームでのfflushの呼び出しと同じです。If stream is NULL, the behavior is the same as a call to fflush on each open stream. 書き込みモードで開いたすべてのストリームと、更新モードで開いて最後の操作が書き込みだったすべてのストリームは、フラッシュされます。All streams opened in write mode and all streams opened in update mode where the last operation was a write are flushed. この呼び出しは、他のストリームに影響がありません。The call has no effect on other streams.

バッファーは通常はオペレーティング システムによって保持され、データをディスクに自動的に書き込むための最適なタイミングが決定されます。タイミングとしては、バッファーがいっぱいになったとき、ストリームが閉じられるとき、プログラムがストリームを閉じずに正常に終了したときがあります。Buffers are normally maintained by the operating system, which determines the optimal time to write the data automatically to disk: when a buffer is full, when a stream is closed, or when a program terminates normally without closing the stream. ランタイム ライブラリのディスクへのコミットの機能を使用すると、重要なデータをオペレーティング システムのバッファーではなく、ディスクに直接書き込むことができます。The commit-to-disk feature of the run-time library lets you ensure that critical data is written directly to disk rather than to the operating-system buffers. プログラムのオブジェクト ファイルを COMMODE.OBJ にリンクすると、既存のプログラムを書き直さずに、この機能を有効にできます。Without rewriting an existing program, you can enable this feature by linking the program's object files with COMMODE.OBJ. 生成された実行可能ファイルでは、 _flushallを呼び出して、すべてのバッファーの内容をディスクに書き込みます。In the resulting executable file, calls to _flushall write the contents of all buffers to disk. _Flushallfflushのみが、commode .obj によって影響を受けます。Only _flushall and fflush are affected by COMMODE.OBJ.

ディスクへのコミットの機能の制御については、「ストリーム入出力」、「fopen」、および「_fdopen」を参照してください。For information about controlling the commit-to-disk feature, see Stream I/O, fopen, and _fdopen.

この関数は呼び出し元スレッドをロックするため、スレッド セーフです。This function locks the calling thread and is therefore thread-safe. ロックしていないバージョンについては、「(_s ) 」を参照してください。For a non-locking version, see _fflush_nolock.

必要条件Requirements

関数Function 必須ヘッダーRequired header
fflushfflush <stdio.h><stdio.h>

互換性の詳細については、「互換性」を参照してください。For additional compatibility information, see Compatibility.

Example

// crt_fflush.c
// Compile with: cl /W4 crt_fflush.c
// This sample gets a number from the user, then writes it to a file.
// It ensures the write isn't lost on crash by calling fflush.
#include <stdio.h>

int * crash_the_program = 0;

int main(void)
{
    FILE * my_file;
    errno_t err = fopen_s(&my_file, "myfile.txt", "w");
    if (my_file && !err)
    {
        printf("Write a number: ");

        int my_number = 0;
        scanf_s("%d", &my_number);

        fprintf(my_file, "User selected %d\n", my_number);

        // Write data to a file immediately instead of buffering.
        fflush(my_file);
    
        if (my_number == 5)
        {
            // Without using fflush, no data was written to the file 
            // prior to the crash, so the data is lost.
            *crash_the_program = 5;
        }

        // Normally, fflush is not needed as closing the file will write the buffer.
        // Note that files are automatically closed and flushed during normal termination.
        fclose(my_file);
    }
    return 0;
}
5
User selected 5

関連項目See also

ストリーム入出力Stream I/O
fclose、_fcloseallfclose, _fcloseall
_flushall_flushall
setvbufsetvbuf