creattemp

io.h：インデックス への移動

ヘッダーファイル

io.h

カテゴリ

入出力ルーチン

プロトタイプ

int creattemp(char *path, int attrib);

説明

パス名に関連付けられたディレクトリに一意のファイルを作成します。

creattemp によって作成されるファイルは，常にグローバル変数 _fmode（O_TEXT または O_BINARY）で指定される変換モードで作成されます。

path は，円記号（\）で終わるパス名です。path で指定されたディレクトリで一意のファイル名が選択されます。新しく作成されたファイル名は，提供された path 文字列に格納されます。path は，作成されるファイル名を格納するために十分な長さが必要です。このファイルは，プログラムが終了しても自動的に削除されることはありません。

creattemp の attrib 引数は，0 または次の定数（dos.h で定義）を OR で組み合わせた値です。

FA_HIDDEN	非表示ファイル
FA_RDONLY	読み出し専用属性
FA_SYSTEM	システムファイル

ファイルの作成が成功すると，ファイルポインタはファイルの先頭に設定されます。このファイルは，読み出しと書き込みの両方の目的で開くことができます。

戻り値

成功した場合は，新しいファイルハンドルとして負でない整数が返されます。そうでない場合は，-1 が返されます。

エラーの場合は，グローバル変数 errno に次のいずれかの値が設定されます。

EACCES	アクセスが許可されない
EMFILE	オープンファイルが多すぎる
ENOENT	パスまたはファイル名が見つからない

例

 #include <string.h>
 #include <stdio.h>
 #include <io.h>
 int main(void)
 {
    int handle;
    char pathname[128];
    strcpy(pathname, "\\");
    /* ルートディレクトリで一意のファイルを作成します */
    handle = creattemp(pathname, 0);
    printf("%s was the unique file created.\n", pathname);
    close(handle);
    return 0;
 }

移植性

POSIX	Win32	ANSI C	ANSI C++
	+