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