PHP マニュアル
前のページ |  | 次のページ

# socket_write

(PHP 4 >= 4.1.0, PHP 5)

socket_write -- ソケットに書き込む

## 説明

int socket_write ( resource socket, string buffer [, int length] )

関数 socket_write() は、 buffer の内容をソケット socket に書き込みます。

オプションのパラメータ length で、ソケットに 書き込むバイト数を指定することが可能です。この値がバッファの長さより 大きい場合、自動的にバッファのサイズに切り詰められます。

ソケットへの書き込みに成功したデータのバイト数を返します。エラー時には `FALSE` を返します。エラーコードは socket_last_error() を用いて取得することができ、この値を socket_strerror() に渡すことでエラー情報を文字列で取得可能です。

> 注意: socket_write() は、バッファの内容を必ずしもすべて 書き込むとは限りません。ネットワークバッファの状態にもよりますが、 たとえ 1 バイトだけ書き込まれたのであったとしても、それはエラーでは なく正常な動作です。そのため、データがすべて書き込まれたのかどうかに 注意する必要があります。

> 注意: socket_write() がゼロを返すことも十分ありえます。 これは、書き込むデータが存在しなかったことを意味します。エラーを チェックするために `FALSE` かどうかを調べる際には、必ず === 演算子を使用しましょう。

socket_accept()、 socket_bind()、 socket_connect()、 socket_listen()、 socket_read() および socket_strerror() も参照ください。

前のページ | ホーム | 次のページ
socket_strerror | 上に戻る | Standard PHP Library (SPL) 関数