# FS_CreateFile

## 構文

    #include <nitro/fs.h>

    BOOL FS_CreateFile(const char *path, u32 permit);

## 引数

path | 生成するファイルのパス名
permit | ファイルへのアクセス権 FS_PERMIT_*のフラグを組み合わせて指定します。

## 返り値

ファイルが正常に生成されればTRUEを、失敗すればFALSEを返します。
失敗時の詳細なエラーは`FS_GetArchiveResultCode()`で取得することができます。

## 説明

指定したファイルを新規に生成します。
以下の場合には失敗してFALSEを返します。

- 対象となるアーカイブがファイルの新規生成に対応できない場合
- すでに同名のファイルが存在する場合

## 注意

- この関数を割り込みハンドラ(IRQモード)から呼び出すことはできません。
  また、割り込みを禁止したままの状態にあると処理が完了しない場合がある点に注意して下さい。

## 参照

`FS_PERMIT_*
FS_DeleteFile FS_RenameFile FS_GetResultCode`

## 履歴

2007/09/18 初版