Arguments

commands

texte unique constitué d'instructions à soumettre à l'interpréteur de commandes du système d'exploitation pour exécution.

echo

Un booléen: Argument nommé optionnel utilisé pour afficher les sorties standards dans la console Scilab.

status

Un entier: code de sortie retourné par l'interpréteur de commande.

stdout

Chaîne de caractère qui contient la sortie standard de la commande exécutée. Lorsque la fonction est appelée avec deux arguments de sortie, stdout contient les deux sorties standards stdout et stderr.

stderr

Chaîne de caractère qui contient la sortie d'erreur de la commande exécutée.

Description

host(…) créée une session de l'interpréteur de commande du système d'exploitation (OS) (sh avec Linux et macOS, cmd.exe avec Windows, etc..) pour exécuter la commande.

host(…) retourne les deux sorties standards dans la même sortie lorsque la fonction a été appelée avec deux arguments de sortie. Ceci permet de garder l'ordre chronologique des logs entre stdout et stderr.

En utilisant l'argument nommé optionnel echo=%t, les deux sortie standards seront afficher dans la console Scilab pendant l'exécution de la commande.

La session de l'interpréteur de commandes créée est un clône de la session OS depuis laquelle Scilab a été lancé. En conséquence, son contexte est le suivant : Son dossier initial de travail (CWD) est le dossier de travail de la session Scilab lors de l'appel à host(…). Ses variables d'environnement initiales sont identiques (noms et valeurs) à celles du terminal OS dans lequel la session Scilab fonctionne (consolebox), au moment où host() est appelée. Elles peuvent être modifiées avec setenv avant l'appel à host(). Toute modification dans la session host() du dossier de travail et/ou des variables d'environnement n'a aucun effet ni sur le dossier de travail de la session Scilab, ni sur les variables d'environnement du terminal OS dans lequel la session Scilab fonctionne. Quand la fonction est appelée avec 3 sorties elle attend la fin de l'exécution de la commande. Lorsque la fonction est appelée avec deux ou trois arguments de sortie, elle attendra la fin de l'execution de la commande pour retourner les sorties.

Examples

disp(SCI)
if getos() == "windows" then
    [stat, stdout] = host("echo %SCI%")
else
    [stat, stdout] = host("echo $SCI")
end

// get separated stdout and stderr
[stat, stdout, stderr] = host("echo OK && echo KO 1>&2 && echo END")
// get both outputs keeping chronological order
[stat, stdout] = host("echo OK && echo KO 1>&2 && echo END")

// Detach a command to avoid waiting for its end
host("ping -c 3 localhost &")
// But, this command will wait for outputs
[stat, stdout] = host("ping -c 3 localhost &")

host("ping -c 3 localhost", echo=%t)

Voir aussi

• consolebox — affiche ou cache le terminal Windows de lancement de Scilab
• getos — donne le nom et la version du système d'exploitation
• setenv — fixe la valeur d'une variable d'environnement
• powershell — executes a command with the Windows powershell interpreter (Windows only)
• Liste de codes de sortie des commandes MS Windows

History