PHP 8.6.0 Beta 3 is available for testing

Yac::get

(PECL yac >= 1.0.0)

Yac::getRecupera valores de la caché

Descripción

public function Yac::get(string|array $key, mixed $default = null): mixed

Recupera valores de la caché

Parámetros

key

Una clave de tipo string, o un array de claves.

default

El valor que se devuelve cuando la clave (o las claves) solicitada no está presente en la caché, disponible a partir de yac 2.4.0. Si se omite, un fallo de caché devuelve false.

Nota:

Antes de yac 2.4.0, esta posición de argumento contenía un token $cas por referencia en lugar de un valor por defecto. El código que pasaba ese token o dependía de él debe actualizarse al migrar a la versión 2.4.0.

Valores devueltos

Para una clave de tipo string, devuelve el valor almacenado en caché si se encuentra, y en caso contrario el valor de default (o false si no se indicó ningún valor por defecto).

Para un array de claves, devuelve un array que contiene los valores encontrados indexados por sus claves. Las claves que no están presentes en la caché se omiten del resultado a partir de yac 2.4.0, o se rellenan con el valor de default si se indicó uno; antes de la versión 2.4.0, se insertaba un marcador false por cada clave ausente.

Ejemplos

Ejemplo #1 Ejemplo de Yac::get()

<?php
$yac = new Yac();

$yac->set("foo", "bar");
var_dump($yac->get("foo"));                 // string(3) "bar"
var_dump($yac->get("missing"));             // bool(false): un fallo de caché
?>

Ejemplo #2 Distinguir un false almacenado de un fallo de caché

<?php
$yac = new Yac();

// un fallo de caché y un false almacenado son indistinguibles sin un valor
// por defecto; un valor centinela (disponible a partir de yac 2.4.0) permite
// diferenciarlos
$yac->set("flag", false);
var_dump($yac->get("flag"));                // bool(false): el valor almacenado
var_dump($yac->get("missing", false));      // bool(false): un fallo de caché, misma forma
var_dump($yac->get("flag", "__NONE__"));    // bool(false): el valor almacenado
var_dump($yac->get("missing", "__NONE__")); // string(8) "__NONE__": un fallo de caché
?>

Ejemplo #3 Recuperar varias claves en una sola llamada

<?php
$yac = new Yac();

$yac->set("foo", "bar");
$yac->set("foo2", "bar2");

// con un array de claves, solo las claves encontradas están presentes en el resultado
var_dump($yac->get(array("foo", "foo2", "missing")));
// array(2) { ["foo"]=> string(3) "bar" ["foo2"]=> string(4) "bar2" }
?>

Véase también

  • Yac::set() - Almacena un valor en la caché
  • Yac::__get() - Recupera un valor usando la sintaxis de propiedades

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top