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

# 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 は、名前のある 定数です。

- PHP_BINARY_READ - システムのread()関数を 使用します。バイナリデータ読み込みに関して安全です。(PHP >= 4.1.0でデフォルト)

- PHP_NORMAL_READ - デフォルト。読み込みは、\r、\nで中断される。 (PHP <= 4.0.6でデフォルト)

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

前のページ | ホーム | 次のページ
socket_listen | 上に戻る | socket_recv