Aller au contenu principal
Version: v4 (Stable)

RECEIVEFROM

RECEIVEFROM(message AS STRING BYREF, origin AS STRING BYREF [, timeout AS INTEGER[, port AS STRING BYREF[, coding As INTEGER]]]) AS INTEGER

Attend la réception d'un message pendant un temps maximum de <timeout> millisecondes, préciser le codage du message attendu avec le paramètre optionnel <coding> 0 pour ANSI(valeur par défaut), 1 pour UNICODE, 2 pour des trames binaires et 3 pour UTF8. Si le paramètre optionnel <timeout> est nul (valeur par défaut), la fonction retourne le message éventuellement reçu, sans attendre. Si <timeout> est égal à -1, la fonction reste en attente du message sans limite. Si un message est reçu, la fonction copie le message dans la variable <message> et l'adresse de l'expéditeur dans la variable <origin>. Dans le cas de scripts IP, le paramètre <port>, lorsqu'il est défini, retourne le numéro du port IP émetteur. Si le paramètre <port> n'est pas défini, le numéro de port est retourné après l'adresse de l'expéditeur dans le paramètre <origin> (format "<ip address>:<port>"). La fonction retourne la longueur du message reçu (si un message est reçu), 0 à l'échéance du timeout, -1 si la communication est abandonnée. Pour les connexions IP, la fonction retourne -2 si la socket est déconnectée et que le script peut continuer son exécution.