stream_select

stream_select(array $read, array $write, array $except, int $seconds, [int $microseconds]): int
```php

`stream_select` acepta un array de flujos y espera a que alguno de ellos cambie de estado. Esta operación es equivalente a lo que hace la función `socket_select`, salvo que trabaja sobre un flujo.

## Parámetros

`read`  
Los flujos que están listados en el parámetro `read` serán supervisados en lectura, es decir, si hay nuevos bytes disponibles para lectura (para ser precisos, si una lectura no bloqueará, lo que incluye también flujos que están al final de archivo, en cuyo caso una llamada a la función `fread` retornará un string de tamaño 0).

`write`  
Los flujos que están listados en el parámetro `write` serán supervisados en escritura (para ser precisos, si una escritura no bloqueará).

`except`  
Los flujos que están listados en el parámetro `except` serán supervisados para ver si se lanza una excepción.

> [!NOTE]
> Cuando `stream_select` termina, los arrays `read`, `write` y `except` son modificados para indicar qué flujos han cambiado de estado actualmente. Las claves originales del array se preservan.

`seconds`  
Los parámetros `seconds` y `microseconds` forman el *tiempo límite*, `seconds` especifica el número de segundos mientras que `microseconds`, el número de microsegundos. El parámetro `timeout` representa el límite superior del tiempo que `stream_select` debe esperar antes de terminar. Si `seconds` está definido a `0` y `microseconds` vale `0` o `null`, `stream_select` no esperará datos - en su lugar, terminará inmediatamente, indicando el estado actual del flujo.

Si `seconds` vale `null`, `stream_select` puede bloquearse indefinidamente, terminando únicamente cuando un evento en alguno de los flujos supervisados ocurra (o si una señal interrumpe la llamada al sistema).

> [!WARNING]
> Utilizar un valor de `0` permite probar instantáneamente el estado de los flujos, pero debe saberse que no se recomienda utilizar `0` en un bucle, ya que esto hará que el script consuma una gran cantidad de procesador.
>
> Es mucho mejor especificar un valor de algunos segundos, incluso si se debe supervisar y ejecutar diferentes códigos de manera simultánea. Por ejemplo, utilizar un valor de al menos `200000` microsegundos, se reducirá considerablemente el consumo de procesador del script.
>
> No se debe olvidar que el valor de expiración es la duración máxima de espera, si no ocurre nada: `stream_select` retornará un resultado tan pronto como uno de los flujos suministrados esté listo para su uso.

`microseconds`  
Véase la descripción de `seconds`.

## Valores devueltos

En caso de éxito, `stream_select` retorna el número de flujos que han cambiado, lo que puede ser `0`, si el tiempo límite fue alcanzado antes de que los flujos cambien. En caso de error, la función retornará `false` y un aviso será devuelto (esto puede ocurrir si la llamada al sistema es interrumpida por una señal entrante).

## Historial de cambios

| Versión | Descripción                       |
|---------|-----------------------------------|
| 8.1.0   | `microseconds` ahora es nullable. |

## Ejemplos

Ejemplo con `stream_select`

Este ejemplo supervisa si los datos llegan para ser leídos ya sea en `$stream1` o en `$stream2`. Si el tiempo límite es `0`, la función termina inmediatamente: