tmpfile、tmpfile_s

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

ファイル入出力

型とオブジェクト
stdinstdoutstderr          FILE fpos_t
関数 ファイルアクセス fopenfopen_s (C11) freopenfreopen_s (C11)   fwide (C95) setbuf setvbuf fclose fflush 非書式化入出力 fgetc fgets fputc fputs getchar getsgets_s (C11まで)(C11) putchar puts ungetc fgetwcgetwc (C95)(C95) fgetws (C95) fputwcputwc (C95)(C95) fputws (C95) getwchar (C95) putwchar (C95) ungetwc (C95) 書式付き入力 scanffscanfsscanfscanf_sfscanf_ssscanf_s (C11)(C11)(C11) wscanffwscanfswscanfwscanf_sfwscanf_sswscanf_s (C95)(C95)(C95)(C11)(C11)(C11) vscanfvfscanfvsscanfvscanf_svfscanf_svsscanf_s (C99)(C99)(C99)(C11)(C11)(C11) vwscanfvfwscanfvswscanfvwscanf_svfwscanf_svswscanf_s (C99)(C99)(C99)(C11)(C11)(C11)	直接入出力 fread fwrite 書式付き出力 printffprintfsprintfsnprintfprintf_sfprintf_ssprintf_ssnprintf_s (C99)(C11)(C11)(C11)(C11) wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)   vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11) vwprintfvfwprintfvswprintfvwprintf_svfwprintf_svswprintf_svsnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11) ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove tmpfiletmpfile_s (C11) rename tmpnamtmpnam_s (C11)

 

ヘッダー <stdio.h> で定義
FILE* tmpfile( void );	(1)
errno_t tmpfile_s( FILE* restrict* restrict streamptr );	(2)	(C11 以降)

1) 一時ファイルを作成して開きます。このファイルは、更新用のバイナリファイルとして開かれます（まるで fopen が "wb+" モードで呼び出されたかのようです）。ファイル名はファイルシステム内で一意であることが保証されます。プログラムの存続期間中に少なくとも TMP_MAX 個のファイルを開くことができます（この制限は tmpnam と共有される可能性があり、さらに FOPEN_MAX によって制限される場合があります）。

2) (1) と同様ですが、少なくとも TMP_MAX_S 個のファイルを開くことができ（この制限は tmpnam_s と共有される可能性があります）、streamptr がヌルポインタの場合、現在インストールされている制約ハンドラ関数が呼び出されます。

すべての境界チェック関数と同様に、`tmpfile_s` は、実装によって __STDC_LIB_EXT1__ が定義されており、ユーザーが <stdio.h> をインクルードする前に __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義している場合にのみ利用可能であることが保証されます。

この関数によって作成された一時ファイルは、プログラムが正常に終了すると閉じられ、削除されます。異常終了時に削除されるかどうかは、実装定義です。

パラメータ

1) (なし)

2) この関数呼び出しによって更新されるポインタへのポインタ

戻り値

1) エラーが発生した場合は、ファイルに関連付けられたファイルストリームへのポインタ、またはヌルポインタ。

2) ファイルが正常に作成され開かれた場合はゼロ、ファイルが作成または開かれなかった場合、または streamptr がヌルポインタであった場合はゼロ以外。さらに、成功時には関連付けられたファイルストリームへのポインタが *streamptr に格納され、エラー時にはヌルポインタ値が *streamptr に格納されます。

備考

一部の実装（例えば古いLinux）では、この関数は実際にファイルを作成、オープンし、すぐにファイルシステムから削除します。削除されたファイルへのオープンされたファイル記述子がプログラムによって保持されている限り、ファイルは存在しますが、削除されたため、その名前はどのディレクトリにも表示されないため、他のプロセスがそのファイルを開くことはできません。ファイル記述子が閉じられるか、プログラムが終了する（正常終了または異常終了）と、ファイルによって占められていた領域はファイルシステムによって回収されます。新しいLinux（ファイルシステムによって異なりますが、3.11以降）では、`open()`システムコールで特別なフラグを使用して、このような見えない一時ファイルを一歩で作成します。

一部の実装（例：Windows）では、関数がシステムディレクトリに一時ファイルを作成する可能性があるため、昇格された権限が必要です。

例

このコードを実行

#define _POSIX_C_SOURCE 200112L
#include <stdio.h>
#include <unistd.h>
 
int main(void)
{
    printf("TMP_MAX = %d, FOPEN_MAX = %d\n", TMP_MAX, FOPEN_MAX);
    FILE* tmpf = tmpfile();
    fputs("Hello, world", tmpf);
    rewind(tmpf);
    char buf[6];
    fgets(buf, sizeof buf, tmpf);
    printf("got back from the file: '%s'\n", buf);
 
    // Linux-specific method to display the tmpfile name
    char fname[FILENAME_MAX], link[FILENAME_MAX] = {0};
    sprintf(fname, "/proc/self/fd/%d", fileno(tmpf));
    if (readlink(fname, link, sizeof link - 1) > 0)
        printf("File name: %s\n", link);
}

実行結果の例

TMP_MAX = 238328, FOPEN_MAX = 16
got back from the file: 'Hello'
File name: /tmp/tmpfjptPe5 (deleted)

参照

• C23標準 (ISO/IEC 9899:2024)

• 7.21.4.3 tmpfile 関数 (p: TBD)

• K.3.5.1.1 tmpfile_s 関数 (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.21.4.3 tmpfile 関数 (p: 222)

• K.3.5.1.1 tmpfile_s 関数 (p: 427)

• C11標準 (ISO/IEC 9899:2011)

• 7.21.4.3 tmpfile 関数 (p: 303)

• K.3.5.1.1 tmpfile_s 関数 (p: 586-587)

• C99標準 (ISO/IEC 9899:1999)

• 7.19.4.3 tmpfile 関数 (p: 269)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.9.4.3 tmpfile 関数

関連項目

tmpnamtmpnam_s (C11)	一意なファイル名を返す (関数)
C++ ドキュメント (tmpfile)