DESCRIPTION.

La fonction FN_tcpconnect() établit une connexion TCP/IP, désignant la machine comme client du réseau.

SYNTAXE.

kclient = FN_tcplisten( 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_tcpconnect() retourne une valeur numérique identifiant le client 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 une erreur est survenue, empêchant l'établissement de connexion, la fonction FN_tcpconnect() retournera 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_tcpconnect() 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 ---

INPUT "IP du serveur, svp : " ; kserveur$

kclient = FN_tcpconnect( kserveur , "1234" )

IF kchaine$ < 1 THEN PROC_Fermeture

PRINT "Connexion etablie."

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

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