DESCRIPTION.

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

SYNTAXE.

TPL_Valeurs = os.lstat ( fichier , descripteur )

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

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

fichier ⇨ nom du fichier [ OBLIGATOIRE ]

descripteur ⇨ descripteur de fichier [ optionnel ]

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.

descripteur est un attribut nommé par dir_fd = valeur, où valeur doit être un int ( ) identifiant un descripteur de fichier valide, ou None, valeur par défaut. descripteur 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.lstat ( ) 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.

La méthode os.lstat ( ) sera utilisée pour les systèmes d'exploitation ne gérant pas les liens symboliques, dans les autres cas on lui préférera la méthode os.stat ( ) ou mieux encore la méthode os.fstat ( ).

EXEMPLE.

import os

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

print ( kstatuts )

print ( )

print ( kstatuts.st_ino )

print ( kstatuts.st_atime )