DESCRIPTION.

Modifie la valeur de la variable d'environnement passée en argument.

SYNTAXE.

os.putenv ( variable , valeur )

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

variable ⇨ nom de la variable d'environnement [ OBLIGATOIRE ]

valeur ⇨ valeur à affecter [ OBLIGATOIRE ]

REMARQUES.

variable doit être un str ( ) valide, correspondant au nom d'une variable d'environnement de l'OS de la machine hote. 

valeur doit être un str ( ) quelconque mais valide pour variable.

L'appel de la méthode os.putenv ( ) affecte valeur à variable.

Les variables d'environnement disponibles pour l'OS de l'utilisateur, et leur valeur, peuvent être consultées avec la constante os.environ qui les retourne dans un dict ( ). for kcle , kvaleur in os.environ.items ( ) : print ( kcle , ":" , kvaleur ) 

Les changements de valeur des variables effectués après le chargement du module os peuvent ne pas être pris en compte par la méthode os.getenv ( ) qui s'appuie uniquement sur la constant os.environ pour retourné les valeurs demandées.

L'utilisation de la méthode os.putenv ( ) affecteront les sous-processus lancés depuis les méthodes os.system ( ), os.popen ( ), os.fork ( ) et os.execv ( ).

Il est préférable de modifier la valeur d'une variable d'environnement avec la syntaxe os.environ [ "variable" ] = valeur, car l'emploi de la méthode os.putenv ( ) ne met pas à jour les valeurs des variables d'environnement dans  os.environ, qui est généré juste après l'importation du module os et qui n'est plus mis à jour ensuite. Les modifications faites par la méthode os.putenv ( ) ne seraient donc pas visibles avec un appel des méthodes os.getenv ( ) et  os.getenvb ( ) ou par la consultation directe de  os.environ.

Si valeur est omis, ou si variable n'est pas une variable d'environnement du système d'exploitation de l'utilisateur, Python lèvera une exception.

Voir la méthode os.getenv ( ) pour obtenir la valeur de variable.

Voir la méthode os.getenvb ( ) pour obtenir la valeur de variable dans un bytes ( ).

EXEMPLE.

import os

print ( "L'utilisateur est :" , os.getenv ( "USER" ) ) 

os.putenv ( "USER" , "xxxxx" ) # indiquer un nouvel utilisateur à la place de xxxxx

print ( "L'utilisateur est :" , os.getenv ( "USER" ) ) 

os.environ [ "USER" ] = "yyyy" # indiquer un nouvel utilisateur à la place de yyyy

print ( "L'utilisateur est :" , os.getenv ( "USER" ) )