Syntax

s32 mfsHFnsplit(const u8* path, u8* drive, u8* dir, u8* name, u8* type)

Arguments

*path   Path name

*drive   Drive name

*dir   Directory name

*name   File name

*type   File extension

Return value

Flag indicating component

Function

Splits pathname into components

Description

This function splits the pathname specified by path into four components (drive name, directory name, file name, and extension) and stores them in the buffers specified by drive, dir, name, and type, respectively. If NULL is specified for a buffer, the corresponding component is only split from the pathname and is not stored.

The maximum sizes of these character strings are defined as follows. These values includes the terminating NULL space.

MFS_MAXPATH	128	Path name
MFS_MAXDRIVE	3	Drive name
MFS_MAXDIR	100	Directory name
MFS_MAXFILE	21	File name
MFS_MAXTYPE	7	Extension

mfsHFnsplit assumes that there is a sufficiently large amount of space to be able to store each non-NULL component. mfsHFnsplit uses the following rules to split path.

* drive contains a colon (such as A: or B:)

* dir contains the directory separator '/' at the beginning and end (such as /nintendo/64/)

* type contains a period before the extension (such as .text or .html)

A flag indicating whether or not a component is contained in path is returned as the return value. The flag has a bit configuration in which the corresponding bits are as follows:

MFS_FNSPLIT_TYPE	0x02
MFS_FNSPLIT_FILENAME	0x04
MFS_FNSPLIT_DIRECTORY	0x08
MFS_FNSPLIT_DRIVE	0x10

mfsHFsplit performs the opposite operation to the operation performed by mfsHFnmerge.