@CHIP-RTOS C Library - BIOS API
Begins a file system directory scan with
int BIOS_Fast_Findfirst (const char far *filename,
FILE_FIND far *find,
unsigned int attributes );
- Pointer to null terminated ASCII file name pattern
for search which may contain * and ? wild card characters.
- Pointer to a
structure that will be initialized inside this API call.
- File attributes (provisional, not used!)
- 0: No file found
- This function and the
provide a slightly faster
findfirst/next access than do the DOS compatible functions available on
(Historically, this function was significantly faster than
the @Chip-RTOS's DOS findfirst/findnext implementation. But
since this time the DOS functions have been corrected so the
speed advantage is no longer an issue here.)
This function places a delete protection
lock on the directory being searched.
This function is reentrant. However, eventually the system will
run out of file system resources (e.g. directory nodes) if too many sessions
are simultaneously active.
These functions work in a similar way to the DOS SWI 0x21 findfirst/next
must be called first. Then the
is used repeatedly as required to iterate through
all the files in a directory matching the specified filename
When a lock protection against directory delete is not desired
between calls to the file iteration functions, the normal C-library
findfirst/findnext functions may instead be used. (Or
for SC1x3/SC2x case.)
The BIOS_Fast_Find_Done function
must be called if the Findfirst/Findnext sequence is stopped prior to
these iteration functions returning with a zero ("File not found")
indication. This is important so that the directory can be unlocked
and file system resources released!
- Long file names can be accessed with the
Long file names cannot be accessed with this API. Only DOS 8.3 file
names can be accessed with this API.
- This library function invokes a RTOS software interrupt.
Refer to this RTOS API function's
for more details.
Supported since or modified in @CHIP-RTOS version
This API List
List of C Libraries
@CHIP-RTOS Main Index
End of document