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

sem_get

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

sem_get — Retorna un identificador de semáforo

Descripción

sem_get(
    int $key,
    int $max_acquire = 1,
    int $permissions = 0666,
    bool $auto_release = true
): SysvSemaphore|false

sem_get() retorna un identificador que podrá ser utilizado para acceder a un semáforo System V.

Una segunda llamada a sem_get() con la misma clave retornará un identificador diferente, pero ambos identificadores permitirán acceder al mismo semáforo.

Si key es 0, un nuevo semáforo privado se crea para cada llamada a sem_get().

Parámetros

key
max_acquire
El número de procesos que pueden reservar simultáneamente el semáforo se especifica en el argumento max_acquire.
permissions
Los permisos del semáforo. Actualmente, este valor solo se aplica si el proceso es el único proceso actualmente adjunto al semáforo.
auto_release
El argumento opcional auto_release especifica si el semáforo debe ser liberado automáticamente al cerrar.

Valores devueltos

Retorna un recurso de semáforo en caso de éxito, y false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 En caso de éxito, esta función retorna una instancia de SysvSemaphore ahora; anteriormente; un resource era retornado.
8.0.0 El tipo de auto_release ha sido modificado de int a bool.

Notas

Advertencia

Al utilizar la función sem_get() para acceder a un semáforo creado fuera de PHP, tenga en cuenta que el semáforo debe haber sido creado como un conjunto de 3 semáforos (por ejemplo, especificando 3 como argumento nsems durante la llamada a la función C semget()), de lo contrario, PHP no será capaz de acceder a este semáforo.

Ver también