Aide:TCPRecv.txt

Document original V3.3.6.1 :

###Function###
TCPRecv

###Description###
Receives data from a connected socket.

###Syntax###
TCPRecv ( mainsocket, maxlen [, flag] )


###Parameters###
@@ParamTable@@
mainsocket
	The connected socket identifier (SocketID) as returned by a <a href="TCPAccept.htm">TCPAccept</a> or a <a href="TCPConnect.htm">TCPConnect</a> function.
maxlen
	max # of characters to receive.
flag
	[optional] Forces the function to return binary data if set to 1 (default is 0, and will auto detect between binary/string).
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns binary/string sent by the connected socket.
Failure:	Returns "" and set @error
@error:	-1 Socket error
	windows API WSAGetError return value (see <a href="http://msdn.microsoft.com/en-us/library/ms740668.aspx">MSDN</a>).
@@End@@


###Remarks###
For backwards compatibility reasons this function will try to return strings by default. If null (0x00) characters are received then the return value will be a binary type.
To force the function to always return binary data (the most sensible option) then use the "flag" parameter set to 1.


###Related###
BinaryLen, BinaryMid, TCPStartup, TCPAccept, TCPConnect, TCPTimeout (Option)


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
TCPRecv

###Description###
Reçoit des données d'une socket connectée.


###Syntax###
TCPRecv ( mainsocket, maxlen [, flag] )


###Parameters###
@@ParamTable@@
mainsocket
	L'ID de la socket principale (SocketID) retourné par un appel à la fonction <a href="TCPAccept.htm">TCPAccept</a> ou <a href="TCPConnect.htm">TCPConnect</a>.
maxlen
	Nombre maximum de caractères à recevoir.
flag
	[optionnel] Force la fonction à retourner les données en binaire si flag = 1 (0 par défaut, et détecte automatiquement le type de données binaire/chaîne).
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès:	Retourne une chaîne de caractère/binaire envoyé par la socket connectée.
Échec:	Retourne "" et fixe @error.
@error:	-1 Erreur de socket.
	Valeur de retour de l'API windows WSAStartup (Voir <a href="http://msdn.microsoft.com/en-us/library/ms740668.aspx">MSDN</a>).
@@End@@


###Remarks###
Pour des raisons de rétro-compatibilité, cette fonction essayera de retourner une chaine de caractère par défaut. Si des caractères null (0x00) sont reçus alors le retour sera de type binaire.
Pour forcer la fonction à retourner des données binaires (l'option la plus logique) alors mettre le paramètre "flag" à 1.


###Related###
<a href="BinaryLen.htm">BinaryLen</a>, <a href="BinaryMid.htm">BinaryMid</a>, <a href="TCPStartup.htm">TCPStartup</a>, <a href="TCPAccept.htm">TCPAccept</a>, <a href="TCPConnect.htm">TCPConnect</a>, <a href="TCPTimeout.htm">TCPTimeout (Option)</a>


###Example###
@@IncludeExample@@

Traducteur : TommyDDR

Contributeurs (pour les modifications avant le Wiki) : Tlem