OS_GBPB 9 (changes)
Showing changes from revision #3 to #4:
Added | Removed | Changed
OS SWI Calls
» OS_GBPB
» OS_GBPB 9
OS_ GBPB 9
(SWI &0C)
| Entry | |
|---|---|
| R0 | 9 |
| R1 | Pointer to directory name |
| R2 | Pointer to buffer |
| R3 | Number of objects to read |
| R4 | Where to start, 0 for first time |
| R5 | Length of buffer |
| R6 | Wildcarded name to match (if 0 “*” is used) |
| Exit | |
|---|---|
| R0 | Preserved |
| R1 | Preserved |
| R2 | Preserved |
| R3 | Number of objects read |
| R4 | Where to continue, or -1 for no more |
| C flag clear if R3 = 0, else set | |
Use
The purpose of this call is to read entries from a specified directory, and return a buffer filled with a list of null-terminated strings consisting of the matched names.
Notes
This SWI reads filename entries from the specified directory, returning a group of 0-terminated strings in the buffer. The correct code structure to call this SWI is:
repeat
{
call OS_GBPB 9
if (R3 <> 0)
{
process buffer
}
} until (R4 = -1)
as it is legal to return R3 = 0 before the end of the directory. Also, do not assume anything about the value in R4.
See also
Other languages documentation
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.