Redémarrer le script (os.restart)

Déclaration

succès, message_erreur = os.restart([ chemin_du_fichier_script ])

Paramètres

• chemin du fichier script
  Chaîne, paramètre facultatif ; lorsqu’un chemin de fichier script valide est fourni, le script redémarre sur le fichier cible. La valeur par défaut est "".

Valeur de retour

• succès
  Booléen ; renvoie false en cas d’échec. L’opération ne peut échouer que lorsque le paramètre chemin du fichier script est fourni ; en cas de succès, la fonction ne renvoie rien (le processus a redémarré).
• message_erreur
  Chaîne ; en cas d’échec, contient le message d’erreur détaillé.

Description

Lorsque chemin du fichier script n’est pas fourni, la fonction redémarre directement le processus du script courant, qui se termine immédiatement. Lorsqu’un chemin du fichier script valide est fourni, le script courant se termine et le fichier script cible est relancé. En cas d’échec, la fonction renvoie false avec un message d’erreur ; l’échec est généralement dû à un paramètre invalide.

Remarques

Script courant désigne le script chargé au démarrage ; si le fichier script est modifié, os.restart() ne charge pas le fichier modifié. Sauf nécessité, n’utilisez pas cette fonction dans un environnement multithread. Un redémarrage sans délai peut provoquer d’autres problèmes logiques ; l’auteur du script doit les éviter.

Exemple 1

os.restart() -- Redémarre sur le « script courant » (et non sur le « fichier script courant »)

Exemple 2

os.restart(utils.launch_args().path) -- Redémarre sur le « fichier script courant »

Remarque : le code ci-dessus utilise la fonction hors de ce chapitre utils.launch_args.