getstat |
Demande les statistiques |
OS-9 C Compiler |
sgstat.h |
Syntaxe
getstat(int code, int filenum, char *buffer);
|
Code 0 |
getstat(int code, int filenum);
|
Codes 1 et 6 |
getstat(int code, int filenum, long *size);
|
Code 2 |
getstat(int code, int filenum, long *pos);
|
Code 5 |
Description
Cette fonction permet de demander l'état du fichier.
Remarque
- Le Code doit être la valeur de l'un des codes standard pour la demande de service getstat. Le paramètre filenum doit être le numéro de chemin d'un fichier ouvert.
Le format de l'appel dépend de la valeur de code.
- Voici la liste des codes :
Code |
Description |
Code 0 |
Ce code permet d'indiquer que le paramètre buffer doit être l'adresse d'un tampon de 32 octets dans lequel le paquet d'état correspondant est copié. Le fichier d'entête contient les
définitions des différentes structures de fichiers et de périphériques à utiliser par le programme. |
Code 1 |
Ce code s'applique uniquement aux périphériques SCF et au test des données disponibles. La valeur de retour est zéro si des données sont disponibles. La valeur -1 est renvoyé s'il n'y
a pas de données. |
Code 2 |
Ce code permet d'indiquer le paramètre size doit être l'adresse d'un long entier dans lequel la taille actuelle du fichier est placée. La valeur de retour de la fonction est -1 en
cas d'erreur et 0 en cas de succès. |
Code 5 |
Ce code permet d'indiquer le paramètre pos doit être l'adresse d'un entier long dans lequel la position actuelle du fichier est placée. La valeur de retour de la fonction est -1 en
cas d'erreur et 0 en cas de succès. |
Code 6 |
Ce code permet de retourner la valeur -1 sur EOF avec une erreur et 0 en cas de succès. |
- Lorsque l'un des appels précédents renvoie -1, l'erreur réelle est renvoyée dans errno.
Dernière mise à jour : Mercredi, le 29 Juillet 2020