top

Описание функции 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() .
corner
My pencil ;)
Главная     Сервисы     Портфолио     Проги     Видео     Контакты     Ссылки     Текст