version 5
RECEVOIR VARIABLE (variable)
Paramètre | Type | Description | |
variable | Variable | Variable dans laquelle recevoir une variable |
Description
La commande RECEVOIR VARIABLE reçoit variable, une variable envoyée par la commande ENVOYER VARIABLE, depuis un document ou un port série préalablement ouvert par la commande REGLER SERIE.
En mode interprété, si la variable n'existe pas préalablement à l'appel de RECEVOIR VARIABLE, elle sera créée, typée et remplie en fonction de ce qui a été reçu. En mode compilé, la variable doit être du même type que celle qui est reçue. Dans les deux cas, le contenu de la variable est remplacé par celui de la variable reçue.
Notes
1. Si vous recevez une variable depuis un document avec cette commande, le document doit avoir été ouvert par la commande REGLER SERIE. Vous ne pouvez pas utiliser RECEVOIR VARIABLE avec un document ouvert par Ouvrir document, Ajouter a document ou Creer document.
2. Cette commande ne fonctionne pas avec les variables de type tableau. Si vous voulez envoyer et recevoir des tableaux via un document ou un port série, utilisez les nouvelles Commandes du thème BLOB, apparues avec la version 6 de 4D.
3. Pendant l'exécution d'un RECEVOIR VARIABLE, l'utilisateur peut interrompre l'opération en appuyant sur les touches Ctrl+Alt+Maj (sous Windows) ou Commande+Option+Maj (sous Mac OS). Cette interruption génère une erreur 9994 que vous pouvez intercepter à l'aide d'une méthode installée par la commande APPELER SUR ERREUR. Généralement, vous devez gérer les interruptions d'une réception uniquement lors d'une communication série.
Exemple
Reportez-vous à l'exemple de la commande RECEVOIR ENREGISTREMENT.
Référence
APPELER SUR ERREUR, ENVOYER ENREGISTREMENT, ENVOYER VARIABLE, RECEVOIR ENREGISTREMENT.
Variables et ensembles système
La variable système OK prend la valeur 1 si la variable est correctement reçue, sinon elle prend la valeur 0.