OS_GBPB 8 (français)
OS SWI Calls
» OS_GBPB
» OS_GBPB 8
OS_ GBPB 8
(SWI &0C)
| En entrée | |
|---|---|
| R0 | 8 |
| R2 | Pointer sur zone mémoire où écrire les données retournée |
| R3 | Nombre d’objets à lire |
| R4 | Indice du premier fichier à retourner, ou 0 pour retourner les fichiers à partir du début |
| En sortie | |
|---|---|
| R0 | Inchangé |
| R2 | Inchangé |
| R3 | Nombre d’objets retournés |
| R4 | Prochain indice de fichier, ou -1 si la lecture est terminé |
| C flag clear if R3 = 0, else set | |
Usage
Cet appel permet de lire les fichiers du dossier courant.
Notes
Les noms de fichiers sont retournés dans la zone mémoire fournie dans R2.
Les données retournées sont de la forme:
| Size | Description |
|---|---|
| 1 octet | Longueur du nom de fichier |
| n octets | Nom du fichier (ASCII) |
| … Répété autant de fois que spécifié dans R3 |
En sortie R4 contient le prochain indice de fichier.
Il n’y a aucune garantie que la fonction vous retourne le nombre de fichiers demandé. Cela est due à des contraintes liées à certains système de fichier.
Pour être sûr que vous avez bien récupéré tous les fichiers d’un dossier, l’appel de cette SWI doit être répété jusqu’à ce que R4 retourne -1.
Cet appel est obsolète. Voir OS_GBPB 9
Voir aussi
Page d’origine
Social
Follow us on
and
and
ROOL Store
Buy RISC OS Open merchandise here, including SD cards for Raspberry Pi and more.