7.99 Socket
7 Index des fonctions
Manuel PHP
. Introduction . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes prédefinies . Socket Errors . Exemples . socket_accept . socket_bind . socket_clear_error . socket_close . socket_connect . socket_create_listen . socket_create_pair . socket_create . socket_get_option . socket_getpeername . socket_getsockname . socket_iovec_add . socket_iovec_alloc . socket_iovec_delete . socket_iovec_fetch . socket_iovec_free . socket_iovec_set . socket_last_error . socket_listen . socket_read . socket_readv . socket_recv . socket_recvfrom . socket_recvmsg . socket_select . socket_send . socket_sendmsg . socket_sendto . socket_set_block . socket_set_nonblock . socket_set_option . socket_shutdown . socket_strerror ->socket_write . socket_writev
|
7.99.42 socket_write()Ecrit dans une socket[ Exemples avec socket_write ] PHP 4 >= 4.1.0
int
socket_write (
resource
socket
,
string
buffer
,
int
length
)
Attention |
Cette fonction est
EXPERIMENTALE
. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.
|
socket_write
écrit dans la socket
socket
les données du buffer
buffer
.
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
automatiquemetn à la taille du buffer lui-même.
socket_write
retourne le nombre d'octets qui ont
pus êter écrits dans la socket, ou bien
FALSE
en cas d'erreur.
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 |
socket_write
n'écrit pas nécessaire tous
les octets du buffer fourni. Il est valide que, suivant certaines
configuration de buffer réseau, que seulement une certaine quantité
de données, même un octets, soit écrit, même 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.
|
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.
|
Voir aussi
socket_accept
,
socket_bind
,
socket_connect
,
socket_listen
,
socket_read
et
socket_strerror
.
|