socket_read

(PHP 4 >= 4.1.0, PHP 5)

socket_read -- ソケットから最大バイト長まで読みこむ

説明

string socket_read ( resource socket, int length [, int type])

警告

この関数は、 実験的なステータスにあります。これは、この関数の 動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告 なく変更される可能性があることを意味します。注意を喚起するとともに自分 のリスクでこの関数を使用して下さい。

関数 socket_read() は、関数 socket_create()または socket_accept()により作成されたソケット リソースsocket から読み込みます。 読み込まれる最大バイト長は、lengthパラメータ で指定します。 読み込みを終了するために\n、\t、\0 を使用することが可能です。 (これは、以下に示すtypeに依存します)

socket_read()は、成功時に文字列としてデータを返 し、エラー時にFALSEを返します。 エラーコードは、socket_last_error()で取得可能で す。このコードは、エラー文字列を取得するために socket_strerror()に渡すことができます。

注意: socket_read()は、通信の終了(すなわち、リモート の接続先が接続を閉じたこと)を示す長さゼロの文字列("")を返す可能性 があります。

オプションのパラメータ type は、名前のある 定数です。

socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_last_error(), socket_strerror(), socket_write()も参照下さい。