Syntax

s32 mfsHFopen(MfsFile* handle, u8* path, u16 mode)

Arguments

*handle   Pointer for storing file handle pointer

*path   File pathname

mode   Mode for opening the 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_NO	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	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.