Get string resource
Get string resource ( resNum {; resFichier} ) : Text
| Paramètre | Type | Description | |
|---|---|---|---|
| resNum | Integer | → | Numéro de ressource |
| resFichier | Time | → | Numéro de référence de fichier de ressources ou tous les fichiers de ressources ouverts si ce paramètre est omis |
| Résultat | Text | ← | Contenu de la ressource STR |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande Get string resource retourne la chaîne stockée dans la ressource chaîne ("STR ") dont vous avez passé le numéro d'ID dans resNum.
Si la ressource n'est pas trouvée, une chaîne vide est retournée et la variable système OK prend la valeur 0 (zéro).
Si vous passez un numéro de référence de fichier de ressources valide dans resFichier, la ressource est recherchée dans ce fichier uniquement. Si vous ne passez pas le paramètre resFichier, c'est la première occurrence de la ressource rencontrée dans la chaîne des fichiers de ressources qui sera retournée.
Note : Une ressource chaîne peut contenir jusqu'à 255 caractères.
Exemple
L'exemple suivant affiche le contenu de la ressource chaîne d'ID=20911 qui doit se trouver dans au moins un des fichiers de ressources ouverts :
ALERT(Get string resource(20911))
Variables et ensembles système
La variable système OK prend la valeur 1 si la ressource est trouvée, sinon elle prend la valeur 0 (zéro).