DESCRIPTION.

La fonction FN_sendtosocket() envoie une suite d'octets débutant à une certaine adresse mémoire via une connexion UDP.

SYNTAXE.

kenvoyees = FN_sendtosocket( socket , debut , quantite , destinataire , port )

REMARQUES.

socket doit être l'identifiant de la variable ayant reçue la valeur retournée par la fonction FN_udpsocket().

debut doit être un nombre entier indiquant l'adresse mémoire du premier octet à transmettre.

quantite doit être un nombre entier indiquant le nombre d'octets à transmettre.

destinataire doit être une valeur numérique indiquant l'adresse IP, en ordre d'octets réseau (big-endian), de la machine qui doit recevoir les données. Si destinataire vaut &ffffffff, les données seront diffusées dans tout le réseau, sinon la valeur de la machine réceptrice peut être obtenue grace aux fonctions FN_sethost() ou FN_recvfromsocke().

port doit être une valeur numérique indiquant le numéro du port du réseau en ordre d'octets réseau (big-endian). la valeur de port peut être connue avec un appel de la fonction FN_setport().

La fonction FN_sendtosocket() va retournée une valeur numérique indiquant le nombre d'octets réellement envoyés par la machine émettrice vers la machine réceptrice, ou une valeur négative en cas d'erreur.

Voir l'instruction DIM qui permet de réserver une zone en mémoire, d'un certain nombre d'octets, et qui retourne dans une variable l'adresse du premier octet de cette zone.

Voir la fonction FN_recvfromsocket() qui réceptionne une suite d'octets via une connexion UDP.

Voir la fonction FN_writesocket() qui envoie une suite d'octets via une connexion TCP/IP.

Voir la fonction FN_writelinesocket() pour envoyer directement une chaine de caractères via une connexion TCP/IP.

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_sendtosocket() 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 

DIM ADR_Debut 1024 : REM --- reserve 1024 octets en memoire et indique l'adresse du premier octet dans ADR_Bebut

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."

kenvoyees = FN_sendtosocket( kmachine , ADR_Debut , 1024 , &ffffffff , FN_setport( "1234" ) )

PRINT kenvoyees "octets envoyes."

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