Documentación offline PHP master

pcntl_sigwaitinfo

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

pcntl_sigwaitinfo

Espera una señal

Descripción#

pcntl_sigwaitinfo(array $signals, [array $info]): int
```php

La función `pcntl_sigwaitinfo` suspende su ejecución hasta la recepción de una de las señales indicadas en `signals`. Si una de las señales ya está en espera (i.e., bloqueada por `pcntl_sigprocmask`), `pcntl_sigwaitinfo` se termina inmediatamente.

## Parámetros

`signals`  
Un array de señales a esperar.

`info`  
El parámetro `info` recibe un array que contiene la información sobre la señal.

Los siguientes elementos están siempre disponibles para todas las señales: signo : número de señal, errno : un número de error, code : código de señal

Los siguientes elementos pueden estar disponibles para la señal `SIGCHLD`: status : valor de salida o señal, utime : tiempo de usuario consumido, stime : tiempo de sistema consumido, pid : número de proceso llamante, uid : identificador del usuario llamante, o del proceso llamante

Los siguientes elementos pueden estar disponibles para las señales `SIGILL`, `SIGFPE`, `SIGSEGV` y `SIGBUS`: addr : dirección de memoria que causó el error

Los siguientes elementos pueden estar disponibles para la señal `SIGPOLL`: band : evento de band, fd : número de puntero de fichero

## Valores devueltos

Devuelve un número de señal en caso de éxito, o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.4.0 | Se lanza una excepción `ValueError` si el `signal` está vacío. |
| 8.4.0 | Se lanza una excepción `TypeError` si el valor de `signal` no es un `int`. |
| 8.4.0 | Se lanza una excepción `ValueError` si el valor de `signal` es inválido. |

## Ejemplos

Ejemplo con `pcntl_sigwaitinfo`

```php

Véase también#

pcntl_sigprocmask, pcntl_sigtimedwait