# sem_acquire

(PHP 4, PHP 5, PHP 7, PHP 8)

sem_acquire — Adquirir un semáforo

### Descripción

sem_acquire(resource `$sem_identifier`, bool `$nowait` = false): bool

sem_acquire() por defecto queda en espera (si es necesario) hasta que el semáforo pueda ser adquirido. Un proceso que intente adquirir un semáforo que ya ha sido adquirido quedará en espera para siempre si al adquirir el semáforo causa que su número máximo de semáforo sea excedido.

Después de procesar una petición, cualquier semáforo adquirido por el proceso pero no liberado explícitamente será liberado automáticamente y se generará un mensaje de tipo warning.

### Parámetros

`sem_identifier`

  `sem_identifier` es un recurso de semáforo obtenido desde sem_get().

`nowait`

  Especifica si el proceso no debería esperar a que el semáforo sea adquirido. Si se establece a `true`, la llamada devolverá `false` inmediatamente si un semáforo no se puede adquirir de inmediato.

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Historial de cambios

Versión | Descripción
--- | ---
5.6.1 | Se añadió el parámetro `$nowait`.

### Ver también

- sem_get() - Obtener el id de un semáforo
- sem_release() - Liberar un semáforo