firstfile

Retrieves information about a file

struct DIRENTRY *firstfile (
        char *name,
        struct DIRENTRY *dir
)

Arguments

name Filename
dir Pointer to DIRENTRY structure that stores information relating to the referenced file

Return Value

dir is returned if the function is successful.
0 is returned in all other cases.

Explanation

Information about the file corresponding to the specified filename is obtained and placed in the DIRENTRY structure pointed to by dir.

Notes

The wildcard character ‘*’ can be used in the filename. Characters after the ‘*’ are ignored.

See Also

DIRENTRY, nextfile()