UpsSys.LireEnvironnement


Fonction Habilitation Optimiser(PasDEffetDeBord) LireEnvironnement(VariableEnvironnement : Nul Ou Caractere) Retourner Nul Ou Caractere;

Description

La fonction LireEnvironnement permet de lire la valeur de la variable environnement VariableEnvironnement. Cette variable doit être définie au moment du lancement du programme ou doit être créée par l'appel à la procédure ChangerEnvironnement.

Si VariableEnvironnement est Nul, le résultat est Nul.

Si la variable environnement est indéfinie, le résultat est Nul.

Pour les plates-formes Windows, il est possible de lire la base de registres. En ce cas, VariableEnvironnement est un chemin menant à une clé du registre à lire. Le séparateur de clés pour définir le chemin de la valeur à mettre à jour est soit division / ou division inversée \.

Exemple


Principal

/*******/

Debut

...

Ecran.Ecrire(LireEnvironnement("ESSAI"));

/* Ecrit la valeur de la variable environnement 'ESSAI'. */ 

...

Ecran.Ecrire(LireEnvironnement("HKEY_LOCAL_MACHINE\\Software\\Essai"));

/* Ecrit la valeur du registre 'Essai'. */ 

...

Fin Principal

Avertissement

Up ! System met à la disposition des programmes les pseudo variables environnement suivantes :

Variable	Signification
SYSTEM_HOME	Répertoire d'installation du système d'exploitation.
UPS_APPLICATION	Identifiant de l'application au sein de Up ! Virtual Technical Machine.
UPS_HOME	Répertoire d'installation d'Up ! Application System.
UPS_NLS	Liste des chemins d'accès aux ressources linguistiques d'Up ! Application System.
UPS_PATH	Liste des chemins d'accès aux exécutables d'Up ! Application System.
UPS_PROJECT	Identifiant du projet au sein de Up ! Virtual Technical Machine.
UPS_USER	Identifiant de l'utilisateur au sein de Up ! Virtual Technical Machine.

Ces variables sont uniquement utilisables en lecture.

Elles peuvent être également employées dans la valeur d'un paramètre de toutes les procédures, les fonctions ou les méthodes d'Up ! System dont la sémantique correspond à un nom de répertoire ou de fichier.

Voir aussi

ChangerEnvironnement pour supprimer, créer ou modifier une variable environnement.

Traduction


-	-	-	-	-	-	-	-	-