Format: s32 mfsHFopen(MfsFile* handle, u8* path, u16 mode)
Arguments: *handle Pointer for storing file handle pointer
*path File pathname mode Mode for opening file
Return value:Error
Function:Opens file
Description: This function opens the file specified by path and sets the file handle pointer to handle.
"path" specifies the file name and its path with a character string. The maximum length of the character string is 128 characters including the terminating NULL.
The following access modes can be specified for mode.
MFS_OPEN_READ 0x0001 Read MFS_OPEN_WRITE 0x0002 Write MFS_OPEN_UPDATE 0x0000 Update MFS_OPEN_APPEND 0x0010 Append MFS_OPEN_CREATE 0x0020 Create
MFS_OPEN_READ and MFS_OPEN_WRITE can be specified at the same time.
When MFS_OPEN_WRITE is specified, MFS_OPEN_APPEND can be specified.
When MFS_OPEN_APPEND is not specified, MFS_OPEN_UPDATE is assumed.
When MFS_OPEN_UPDATE is used, the existing file contents are lost.
When only MFS_OPEN_READ is specified, the MFS_OPEN_UPDATE and MFS_OPEN_APPEND specifications are ineffective.
Main errors:
MFS_ERR_NO Normal termination MFS_ERR_FATAL File cannot be opened There is no free file handle. MFS_ERR_NOTFOUND File not found The file was not found, or the directory was not found. MFS_ERR_NAME File name error The pathname does not contain a file name, or there is no extension. MFS_ERR_REFUSE Illegal operation A ROM area was opened in write mode.