DESCRIPTION.

Retourne un objet contenant les informations sur les statuts d'un fichier.

SYNTAXE.

TPL_Valeurs = os.stat ( fichier )

TPL_Valeurs = ⇨ variable qui recevra la valeur retournée [ optionnel ]

os.stat ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

fichier ⇨ nom du fichier [ OBLIGATOIRE ]

REMARQUES.

fichier doit être un : 

- str ( ), ou un bytes ( ), indiquant le chemin absolu, ou relatif, d'un fichier présent sur l'un des supports de masse disponibles ; 

- int ( ) correspondant au descripteur d'un fichier actuellement ouvert.

La méthode os.stat ( ) n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

L'appel de la méthode os.stat ( ) retourne un objet de type os.stat_result ( ), assimilable à un tuple ( ) à champs nommés, qui sont :

- st_atime : moment de l'accès le plus récent, exprimé en secondes ;

- st_atime_ns : moment de l'accès le plus récent, exprimé en nanosecondes, par un entier ;

- st_birthtime : date et heure de la création du fichier, sous UNIX ;

- st_blksize : longueur de bloc recommandé pour des entrées-sorties efficaces, sous UNIX ;

- st_blocks : quantité de blocs de 512 bytes alloués pour le fichier, sous UNIX ;

- st_creator : utilisateur créateur du fichier, sous UNIX ;

- st_ctime : sous Unix, le moment du changement de méta-données le plus récent sur Unix ;

- st_ctime : ssousur Windows,e moment de création sur Windows, exprimé en secondes ;

- st_ctime_ns : sous Unix, le moment du changement de méta-données le plus récent ;

- st_ctime_ns : sous Windows, le moment de création, exprimé en nanosecondes, par un entier ;

- st_dev : identifiant du périphérique sur lequel ce fichier se trouve ;

- st_file_attributes : options du fichier, sous Windows ;

- st_flags : options du fichier définit par l'utilisateur, sous UNIX ;

- st_fstype : identifie sans équivoque le type du système de fichiers contenant le fichier, sous UNIX ;

- st_gen : version, génération, du fichier, sous UNIX ;

- st_gid : identifiant de groupe du propriétaire du fichier ;

- st_ino : sous Unix, lorsqu'il ne vaut pas 0, le numéro d'inode pour une certaine valeur de st_dev ;

- st_ino : sous Windows, lorsqu'il ne vaut pas 0, l’index de fichier pour une certaine valeur de st_dev ;

- st_mode : type du fichier et bits de mode du fichier (permissions) ;

- st_mtime : moment de la modification de contenu la plus récente, exprimé en secondes ;

- st_mtime_ns : moment de la modification de contenu la plus récente, exprimé en nanosecondes ;

- st_nlink : nombre de liens matériels ;

- st_rdev : si l'inode représente un périphérique, retourne son type, sous UNIX ;

- st_reparse_tag : identification du type de point d'analuyse, sous Windows ;

- st_rsize : taille, réelle, du fichier, sous UNIX ;

- st_size : taille du fichier en bytes si c'est un fichier normal ou un lien symbolique ;

- st_type : type fondamntal du fichier, sous UNIX ;

- st_uid : identifiant d'utilisateur du propriétaire du fichier.

Depuis Python 3.3, la méthode os.stat ( ) équivaut à un appel de la méthode os.fstat ( ).

EXEMPLE.

import os

kstatuts = os.stat ( "/home/login/Documents/test.txt" )

print ( kstatuts )

print ( )

print ( kstatuts.st_ino )

print ( kstatuts.st_atime )