socket_write
Écrit dans un socket
&reftitle.description;
intfalsesocket_write
Socketsocket
stringdata
intnulllength&null;
socket_write écrit dans le socket
socket les données du buffer
data.
&reftitle.parameters;
socket
data
Le buffer à écrire.
length
Le paramètre optionnel length peut spécifier
explicitement la taille des données qui doivent être écrites. Si cette
longueur est plus grande que la taille du buffer, elle sera ramenée
automatiquement à la taille du buffer lui-même.
&reftitle.returnvalues;
socket_write retourne le nombre d'octets qui ont
pu être écrits dans le socket&return.falseforfailure;.
Le code d'erreur généré peut être obtenu en appelant la fonction
socket_last_error. Ce code d'erreur
peut être passé à la fonction socket_strerror
pour obtenir un message d'erreur, humainement lisible.
Il est parfaitement valide pour socket_write de
retourner zéro, ce qui signifie qu'aucun octet n'a été écrit. Soyez
bien sûr d'utiliser l'opérateur === pour
comparer le retour de la fonction avec &false;, et détecter un
cas d'erreur.
&reftitle.changelog;
&Version;
&Description;
&sockets.changelog.socket-param;
8.0.0
length est désormais nullable.
&reftitle.notes;
socket_write n'écrit pas nécessairement tous
les octets du buffer fourni. Il est valide que, suivant certaines
configuration de buffer réseau, seulement une certaine quantité
de données, même un octet, soit écrit, y compris si votre buffer
est plus grand. Vous devez alors vous assurer que vous n'avez
pas oublié de transmettre le reste de vos données.
&reftitle.seealso;
socket_accept
socket_bind
socket_connect
socket_listen
socket_read
socket_strerror