DESCRIPTION.

La fonction FN_readlinesocket() réceptionne une chine de caractères.

SYNTAXE.

ketat = FN_readlinesocket( socket , attente , chaine )

REMARQUES.

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

- FN_tcplisten(), si l'envoi est fait depuis un client vers le serveur :

- FN_check_connection(), si l'envoi est fait depuis un serveur vers le client qui l'a sollicité.

attente doit être un nombre entier indiquant le temps, en centièmes de seconde, la durée maximal d'attente pour la réception de la chaine de caractères.

chaine doit être l'identifiant d'une variable de type $ existante, qui sera affectée avec la chaine de caractères reçue.

L'appel de la fonction FN_readlinesocket() attend, durant une durée maximale de attente centième de seconde, un chaine de caractères terminée par : LF (saut de ligne) ; CR (retour chariot) ; CRLF ou LFCR. Le caractère de fin de ligne ne sera pas inclus dans la chaine.

Si une erreur est survenue durant la réception des données la FN_readlinesocket() retournera la valeur -1.

Voir la fonction FN_readsocket() qui réceptionne une suite d'octets pour les écrite dans une zone mémoire.

Voir la fonction FN_writelinesocket() pour envoie une chaine de caractères.

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_readlinesocket() 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 serveur ---

kserveur = FN_tcplisten( "" , "1234" )

REM --- Mise en attende d'une sollicitation du client ---

PRINT "Serveur en attente sur le port 1234..."

REPEAT

  kclient = FN_check_connection( kserveur )

UNTIL kclient <> 0

PRINT "Client connecté !"

REM --- reception de donnees sous la forme de 1024 valeurs d'octets ---

krecu$ = ""

ketat = FN_readlinesocket( kclient , 100 , krecu$ )

IF ketat <> -1 THEN PRINT "Recu : " ; krecu$ ELSE PRINT "Erreur de reception."

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

PRINT "Client déconnecte."

PROC_closesocket( kclient )

REM --- Fermeture du reseau ---

PRINT "Reseau ferme."

PROC_Fermeture

END

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

DEF PROC_Fermeture

PROC_exitsockets

QUIT

ENDPROC