Saltar al contenido principal

Reiniciar el script (os.restart)

Declaración

exito, mensaje_error = os.restart([ ruta_del_archivo_de_script ])

Parámetros

  • ruta_del_archivo_de_script
    Tipo texto, parámetro opcional. Si se pasa una ruta de archivo de script válida, se reinicia en el archivo de destino. El valor predeterminado es ""

Valores devueltos

  • exito
    Tipo booleano; devuelve false si la operación falla. Solo puede fallar cuando se pasa el parámetro ruta_del_archivo_de_script; cuando tiene éxito, la función no devuelve nada porque el proceso ya se ha reiniciado
  • mensaje_error
    Tipo texto; mensaje de error concreto cuando la operación falla

Descripción

Si no se pasa ruta_del_archivo_de_script, la función reinicia directamente el proceso del script actual, que termina inmediatamente.
Si se pasa una ruta_del_archivo_de_script válida, el script actual termina y se reinicia en el archivo de script de destino.
Si la operación falla, la función devuelve false junto con un mensaje de error; normalmente el fallo se debe a parámetros no válidos.

Aspectos importantes

Script actual se refiere al script cargado al iniciar; si se modifica el archivo del script, os.restart() no carga el archivo modificado.
No uses esta función en un entorno con varios hilos salvo que sea necesario.
Un reinicio sin demora puede causar otros problemas lógicos, que el autor del script debe evitar por su cuenta.

Ejemplo 1

os.restart() -- reiniciar en el «script actual» (no en el «archivo del script actual») 

Ejemplo 2

os.restart(utils.launch_args().path) -- reiniciar en el «archivo del script actual»

Nota: el código anterior utiliza la función utils.launch_args, que no pertenece a este capítulo.