STAT |
Statistique |
|---|---|
| sys/stat.h |
Syntaxe
| int stat(const char *restrict path, struct stat *restrict buf); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| path | Ce paramètre permet d'indiquer le(s) nom(s) de fichier(s) | ||
| buf | Ce paramètre permet de retourner les informations sur le fichier : | ||
| Champs | Type de données | Description | |
| st_dev | dev_t | Ce champ permet de retourner l'identificateur de périphérique contenant le fichier. | |
| st_ino | short | Ce champ permet de retourner le inode. | |
| 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 permet de retourner l'identificateur d'utilisateur | |
| st_gid | int | Ce champ permet de retourner l'identificateur de groupe | |
| 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 champs permet de retourner la date et l'heure de la création | |
Description
Cette fonction permet de demander tous les propriétés d'un fichier.
Remarques
- La fonction stat() doit obtenir des informations sur le fichier nommé et les écrire dans la zone pointée par le paramètre buf. Le paramètre path pointe vers un chemin d'accès nommant un fichier. L'autorisation de lecture, d'écriture ou d'exécution du fichier nommé n'est pas requise. Une mise en oeuvre fournissant des mécanismes de contrôle d'accès aux fichiers supplémentaires ou alternatifs peut, dans des conditions définies par la mise en oeuvre, provoquer l'échec de la fonction stat(). En particulier, le système peut nier l'existence du fichier spécifié par path.
- Si le fichier nommé est un lien symbolique, la fonction stat() continuera la résolution du chemin en utilisant le contenu du lien symbolique et retournera les informations relatives au fichier résultant si le fichier existe.
- Le paramètre buf est un pointeur vers une structure stat, telle que définie dans l'entête sys/stat.h, dans laquelle sont placées les informations concernant le fichier.
- La fonction stat() doit mettre à jour tous les champs liés au temps, avant d'écrire dans la structure stat.
Voir également
Langage de programmation - Turbo C - Référence procédures et fonctions - stat
Dernière mise à jour : Mercredi, le 10 février 2010