DESCRIPTION.

Modifie le moment de la dernière modification et du temps d'accès d'un fichier.

SYNTAXE.

os.utime ( fichier , options , descripteur , symbolique )

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

fichier ⇨ nom du fichier à ouvrir [ OBLIGATOIRE ]

options ⇨ options d'ouverture [ optionnel ]

descripteur ⇨ descripteur [ optionnel ]

symbolique ⇨ lien symbolique [ 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.

options est un attribut nommé soit :

-  times = None, par défaut, ou times = ( acces , moment ) où acces et moment sont exprimés en secondes ;

-  ns = ( acces , moment ) ou acces et moment sont exprimés en nano-secondes.

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.

symbolique est un attribut nommé par follow_symlinks = valeur, où valeur doit être un bool ( ) symbolique 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. Si valeur vaut :

- True, valeur par défaut, os.chown ( ) opère sur le fichier pointé par chemin ; 

- False, et que le dernier élément du chemin est un lien symbolique, os.chown ( ) teste le lien symbolique et non le fichier.

L'appel de la méthode os.utime ( ). modifie : 

- la valeur de l'attribut st_atime et de l'attribut st_atime_ns en fonction de la valeur passée par acces ;

- la valeur de l'attribut st_mtime et de l'attribut st_mtime_ns en fonction de la valeur passée par moment ;

de l'objet  os.stat_result ( ), consultable grâce à la méthode os.stat ( ).

Les arguments times et ns, sont respectivement exclusifs, ils ne peuvent être employés dans le même appel de la méthode os.utime ( ). L'attribut ns n'étant disponible que depuis Python 3.3,  et  pour assurer la rétrocompatibilité avec d'anciens scripts, si options n'est pas un argument nommé, le tuple ( ) sera interprété comme étant le paramètre times.  

si options est omis ou s'il vaut times = None, alors : 

- acces sera égale à os.stat ( fichier ).st_atime_ns et ;

- moment sera égale à os.stat ( fichier ).st_mtime_ns.

EXEMPLE.

import os

kfichier = "/home/login/Documents/votrefichier.est" # précisez un nom de fichier valide

def FNC_Lecture ( ) :

print ( "os.stat ( ).st_atime vaut" , os.stat ( kfichier ).st_atime , "seondes." )

print ( "os.stat ( ).st_mtime vaut" , os.stat ( kfichier ).st_mtime , "seondes." )

print ( "os.stat ( ).st_atime_ns vaut" , os.stat ( kfichier ).st_atime_ns , "seondes." )

print ( "os.stat ( ).st_mtime_ns vaut" , os.stat ( kfichier ).st_mtime_ns , "seondes." )

print ( )

print ( "AVANT MODIFICATION :"  )

FNC_Lecture ( )

os.utime ( kfichier , times = ( 13000 , 4500 ) )

print ( "APRES MODIFICATION :"  )

FNC_Lecture ( )

os.utime ( kfichier )

print ( "SANS MODIFICATION :"  )

FNC_Lecture ( )