array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.sem-acquire.php', 1 => 'sem_acquire', 2 => 'Reserva un semáforo', ), 'up' => array ( 0 => 'ref.sem.php', 1 => 'Funciones de Semáforo', ), 'prev' => array ( 0 => 'function.msg-stat-queue.php', 1 => 'msg_stat_queue', ), 'next' => array ( 0 => 'function.sem-get.php', 1 => 'sem_get', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/sem/functions/sem-acquire.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sem_acquire

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

sem_acquire — Reserva un semáforo

Descripción

sem_acquire(SysvSemaphore $semaphore, bool $non_blocking = false): bool

sem_acquire() se bloquea por omisión (si es necesario) hasta que el semáforo pueda ser reservado. Un proceso que intenta reservar un semáforo que ya ha reservado quedará en espera indefinida, si esta adquisición excede el número máximo de adquisiciones simultáneas (max_acquire).

Al final de un script, todos los semáforos reservados pero no liberados explícitamente, serán liberados automáticamente, y se generará una advertencia.

Parámetros

semaphore
semaphore es un recurso de semáforo, obtenido de la función sem_get().
non_blocking
Especifica si el proceso no debe esperar la adquisición del semáforo. Si es true, la llamada devolverá false inmediatamente si un semáforo no puede ser adquirido inmediatamente.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.0.0 semaphore ahora espera una SysvSemaphore; anteriormente, se esperaba un resource.

Ver también