creatnew

提供: RAD Studio
移動先: 案内検索

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++

+