socket_write
socket_write
(PHP 4 >= 4.1.0)
socket_write - записывает в сокет.
Описание
int socket_write (resource socket, string buffer [, int length])
| Предупреждение! |
|---|
Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. |
Функция socket_write() записывает в сокет socket из буфера buffer.
Необязательный параметр length может специфицировать альтернативную длину байтов, записываемых в сокет. Если параметр length больше длины буфера, он скрыто усекается до длины буфера.
Возвращает количество байтов, успешно записанных в сокет, или FALSE при ошибке. Код ошибки можно запросить функцией socket_last_error(). Этот код можно передать функции socket_strerror() для получения текстового объяснения ошибки.
Примечание: socket_write() не обязательно записывает все байты из данного буфера. В зависимости от сетевых буферов etc., записывается только определённое количество данных, даже один байт, даже если ваш буфер больше. Вы должны отследить, чтобы не забыть случайно, передачу остатка ваших данных.
Примечание: для socket_write() совершенно правильным будет возврат 0, что означает отсутствие записанных байтов. Используйте операцию === для проверки FALSE в случае ошибки.
См. также socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_read() и socket_strerror().