socket_write
(PHP 4 >= 4.1.0, PHP 5)
socket_write — Écrit dans un socket
Description
$socket
, string $buffer
[, int $length
= 0
] )
socket_write() écrit dans le socket
socket
les données du buffer
buffer
.
Liste de paramètres
-
socket
-
-
buffer
-
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.
Valeurs de retour
socket_write() retourne le nombre d'octets qui ont
pu être écrits dans le socket ou FALSE
si une erreur survient.
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.
Note:
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.
Notes
Note:
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.
Voir aussi
- socket_accept() - Accepte une connexion sur un socket
- socket_bind() - Lie un nom à un socket
- socket_connect() - Crée une connexion sur un socket
- socket_listen() - Attend une connexion sur un socket
- socket_read() - Lit des données d'un socket
- socket_strerror() - Retourne une chaîne décrivant un message d'erreur