DESCRIPTION.

La fonction FN_udpsocket() établit une connexion UDP et peut éventuellement se lier à l'hote.

SYNTAXE.

kmachine = FN_udpsocket( serveur , port )

REMARQUES.

serveur doit être une chaine de caractère au format 'xxx.xxx.xxx.xxx" où xxx.xxx.xxx.xxx est l'adresse IP de la machine distante connectée au réseau en tant que serveur.

port doit être une chaine de caractère au format 'xxxxx" où xxxxx est la valeur du port, l'entré/sortie, sur lequel la machine va communiquer avec un serveur ayant un socket d'écoute sur le même port. xxxxx doit être une valeur numérique comprise entre 1024 et 49151 pour un réseau privé.

L'appel de la fonction FN_udpsocket() retourne une valeur numérique identifiant la machine dans le réseau. Cette valeur devra affecter une variable, afin de pouvoir être utilisée par d'autres procédures et fonctions du module socklib.bbc, qui souhaiteraient connaitre un l'identité de ce client. Si vous ne souhaitez pas associer le socket, fournissez des chaines vides ("") comme paramètres.

Si une erreur est survenue, empêchant l'établissement de connexion, la fonction FN_udpsocket() retournera 0 ou une valeur négative. Voir la fonction FN_socketerror et/ou FN_socketerror$ pour plus de détails sur les erreurs retournées par le réseau.

Rappel : la procédure PROC_initsockets() doit être appelée avant toute autre utilisation d'une procédure ou fonction du module socklib.bbc. et la procédure PROC_exitsockets devra être appelée dès que toutes les opérations de communication seront terminées, et avant de terminer et de fermer l'application.

La fonction FN_udpsocket() est importée depuis le module socklib.bbc. 

EXEMPLE.

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "socklib.bbc"

REM --- INITIALISATION GENERALE ---

ON CLOSE PROC_Fermeture 

REM --- Initialisation de socklib ---

PROC_initsockets

REM --- Creation du client ---

kmachine = FN_udpsocket( "" , "1234" )

IF kmachine > 0 THEN PRINT "Connexion etablie." ELSE PRINT "Une erreur est survenue."

REM --- Fermeture du canal de communication (socket) ---

INPUT "Appuyez sur entree pour continuer ... " ; kpause$

PRINT "Déconnection du client."

PROC_closesocket( kclient )

PROC_Fermeture

END

REM --- Gestion de la fermeture du programme ---

DEF PROC_Fermeture

PROC_exitsockets

QUIT

ENDPROC