Get text resource
Get text resource ( resNum {; resFichier} ) -> Résultat
| 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 TEXT |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande Get text resource retourne le texte stocké dans la ressource texte ("TEXT") dont vous avez passé le numéro d'ID dans resNum.
Si la ressource n'est pas trouvée, un texte vide est retourné 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 texte peut contenir jusqu'à 32 000 caractères.
Exemple
L'exemple suivant affiche le contenu de la ressource texte d'ID=20800 qui doit se trouver dans au moins un des fichiers de ressources ouverts :
ALERT(Get text resource(20800))
Variables et ensembles système
OK prend la valeur 1 si la ressource est trouvée, sinon elle prend la valeur 0 (zéro).