creatnew

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

ヘッダーファイル

io.h

カテゴリ

入出力ルーチン

プロトタイプ

int creatnew(const char *path, int mode);

説明

新しいファイルを作成します。

creatnew の機能は _rtl_creat とほとんど同じですが，ファイルが存在する場合はエラーを返し，ファイルがそのまま残される点が異なります。

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

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

戻り値

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

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

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

例

 #include <string.h>
 #include <stdio.h>
 #include <errno.h>
 #include <io.h>
 int main(void)
 {
    int handle;
    char buf[11] = "0123456789";
    /* まだ存在しないファイルを作成します */
    handle = creatnew("DUMMY.FIL", 0);
 if (handle == -1)
       printf("DUMMY.FIL already exists.\n");
    else
    {
       printf("DUMMY.FIL successfully created.\n");
       write(handle, buf, strlen(buf));
       close(handle);
    }
    return 0;
 }

移植性

POSIX	Win32	ANSI C	ANSI C++
	+