stream_set_blocking

ストリームのブロックモードを有効にする / 解除する

説明

bool stream_set_blocking(resource $stream, bool $enable)

stream のモードをブロックあるいは非ブロックに設定します。

この関数は、非ブロックモードをサポートするすべてのストリーム (現在は、通常のファイルストリームとソケットストリームのみ) において利用可能です。

パラメータ

stream

ストリーム。

enable

enablefalse の時、ストリームは 非ブロックモードに切り替えられ、true の場合は、 ブロックモードに切り替えられます。このモードの違いは、 fgetsfread といった、ストリームからデータを読む関数に影響します。 非ブロックモードにおいては fgets を呼び出すと どんな場合でもただちに呼び出し元に戻りますが、ブロックモードの場合では、 ストリームがデータを読み出せる状態になるまで待ちつづけます。

戻り値

成功した場合に true を、失敗した場合に false を返します。

注意

注意:

Windowsでは、これはローカルファイルには影響しません。 ローカルファイルのノンブロッキングI/Oは、Windowsではサポートされていません。

参考

  • stream_select