FSTAT |
Statistique sur fichier |
|---|---|
| Turbo C | sys\types.h, sys\stat.h |
Syntaxe
| int fstat(int Handle,struct stat *Buffer) |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| Handle | Ce paramètre permet d'indiquer l'identificateur de fichier Handle | ||
| Buffer | Ce paramètre permet de retourner les informations sur le fichier : | ||
| Champs | Type de données | Description | |
| st_dev | short | Ce champ permet de retourner l'unité de disque contenant le fichier | |
| st_ino | short | Ce champ n'est pas utilisé | |
| st_mode | short | Ce champ permet de retourner l'état du mode de fichier | |
| st_nlink | short | Ce champ permet de retourner le numéro de lien | |
| st_uid | int | Ce champ n'est pas utilisé sous DOS | |
| st_gid | int | Ce champ n'est pas utilisé sous DOS | |
| st_rdev | short | Ce champ permet de retourner l'unité de disque | |
| st_size | long | Ce champ permet de retourner la taille du fichier | |
| st_atime | long | Ce champ permet de retourner la date et l'heure du dernière accès | |
| st_mtime | long | Ce champ permet de retourner la date et l'heure de la dernière modification | |
| st_ctime | long | Ce champ permet de retourner la date et l'heure de la création | |
Retour
| Valeur | Description |
|---|---|
| 0 | Cette valeur permet d'indiquer que l'opération a été un succès. |
| -1 | Cette valeur permet d'indiquer qu'une erreur s'est produite et qu'il n'a pas été possible de lire le fichier. Dans ce cas, il sera possible d'obtenir des informations supplémentaires en consultant la variable errno. |
Description
Cette fonction permet de retourner divers informations sur un identificateur de fichier Handle.
Remarques
- Les codes d'erreurs retournés par la variable «errno» correspondent généralement à ceci :
- De nombreux champs ne sont pas utilisés avec le système d'exploitation de style DOS mais existe à titre de compatibilité avec les autres systèmes d'exploitation.
- Si vous souhaitez obtenir les informations sur un fichier sans passé par un gestionnaire «Handle», vous devriez plutôt utiliser la fonction «stat».
| Constante | Description |
|---|---|
| EBADF | Cette constante permet d'indiquer que le descripteur de fichier est invalide. |
Exemple
Voici un exemple montrant une utilisation classique de cette fonction :
- #include <sys/types.h>
- #include <sys/stat.h>
- #include <fcntl.h>
- #include <stdio.h>
-
- int main() {
- struct stat FileInfo;
- int Handle = open("C:\\AUTOEXEC.BAT", O_RDWR);
- if(fstat(Handle, &FileInfo) == 0) {
- printf("Taille du fichier = %i\n",FileInfo.st_size);
- printf("Unité de disque = %i\n",FileInfo.st_rdev);
- }
- return 0;
- }
on obtiendra le résultat semblable suivant :
Taille du fichier = 0Unité de disque = 2
Voir également
Langage de programmation - Turbo C - Référence de fonctions - access
Langage de programmation - Turbo C - Référence de fonctions - chmod
Langage de programmation - Turbo C - Référence de fonctions - stat
Dernière mise à jour : Samedi, le 4 juillet 2015