socket_write
(PHP 4 >= 4.1.0, PHP 5)
socket_write — Escribir en un socket
Descripción
$socket
, string $buffer
[, int $length = 0
] )
La función socket_write() escribe en el
socket desde el
buffer dado.
Parámetros
-
socket -
-
buffer -
El buffer a ser escrito.
-
length -
El parámetro opcional
lengthpuede especificar una longitud alternativa de bytes escritos en el socket. Si esta longitud es mayor que la longitud del buffer se trunca de forma silenciosa a la longitud del buffer.
Valores devueltos
Devuelve el número de bytes escritos con éxito en el socket o FALSE en caso de error.
El código de error se puede recuperar con
socket_last_error(). Este código se puede
pasar a socket_strerror() para obtener una explicación textual del
error.
Nota:
Es perfectamente válido que socket_write() devuelva cero, lo que significa que no se han escrito bytes. Asegúrese de usar el operador === para verificar
FALSEen caso de un error.
Notas
Nota:
socket_write() no escribe necesariamente todos los bytes desde el buffer dado. Esto es válido ya que depende de los búferes de red, etc., sólo se escribe una cierta cantidad de informaicón, incluso un byte, aunque su buffer sea mayor. Debe tener cuidado de no olvidar inintencionadamente de transmitir el resto de la información.
Ver también
- socket_accept() - Acepta una conexión de un socket
- socket_bind() - Vincula un nombre a un socket
- socket_connect() - Inicia una conexión sobre un socket
- socket_listen() - Escucha una conexión sobre un socket
- socket_read() - Lee un máximo de longitud de bytes desde un socket
- socket_strerror() - Devuelve una cadena que describe un error de socket