stream_set_blocking

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

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

説明

stream_set_blocking(resource $stream, bool $enable): bool

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

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

パラメータ

stream

ストリーム。

enable

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

戻り値

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

注意

注意:

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

参考

  • stream_select() - select() システムコールと同等の操作を、 ストリームの配列に対して seconds と microseconds で指定されたタイムアウト時間をもって行う
関連キーワード: 　ストリーム, ブロック, モード, stream, 解除, 関数, blocking, ローカル, 注意, 影響