array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'yac.get.php', 1 => 'Yac::get', 2 => 'Récupère des valeurs du cache', ), 'up' => array ( 0 => 'class.yac.php', 1 => 'Yac', ), 'prev' => array ( 0 => 'yac.flush.php', 1 => 'Yac::flush', ), 'next' => array ( 0 => 'yac.getter.php', 1 => 'Yac::__get', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/yac/yac/get.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Yac::get

(PECL yac >= 1.0.0)

Yac::get — Récupère des valeurs du cache

Description

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

Récupère des valeurs du cache.

Liste de paramètres

key

Une clé string, ou un array de clés.

default

La valeur à retourner quand la clé (ou les clés) demandée n'est pas présente dans le cache, disponible à partir de yac 2.4.0. Quand omis, un défaut de cache retourne false.

Note:

Avant yac 2.4.0, cet emplacement d'argument contenait un jeton $cas par référence plutôt qu'une valeur par défaut. Le code qui passait ou se reposait sur ce jeton doit être mis à jour lors d'une montée en version vers 2.4.0.

Valeurs de retour

Pour une clé string, retourne la valeur mise en cache en cas de succès, sinon la default (ou false si aucune valeur par défaut n'a été donnée).

Pour un array de clés, retourne un tableau contenant les valeurs trouvées indexées par leurs clés. Les clés absentes du cache sont omises du résultat à partir de yac 2.4.0, ou remplies avec la default quand une a été fournie ; avant 2.4.0, un placeholder false était inséré pour chaque clé manquante.

Exemples

Exemple #1 Exemple avec 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): défaut de cache
?>

Exemple #2 Distinguer un false stocké d'un défaut de cache

<?php
$yac = new Yac();

// un défaut de cache et un false stocké sont indiscernables sans valeur par défaut ;
// une valeur sentinelle (disponible à partir de yac 2.4.0) les distingue
$yac->set("flag", false);
var_dump($yac->get("flag"));                // bool(false): la valeur stockée
var_dump($yac->get("missing", false));      // bool(false): un défaut de cache, même forme
var_dump($yac->get("flag", "__NONE__"));    // bool(false): la valeur stockée
var_dump($yac->get("missing", "__NONE__")); // string(8) "__NONE__": un défaut de cache
?>

Exemple #3 Récupération de plusieurs clés en un appel

<?php
$yac = new Yac();

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

// avec un tableau de clés, seules les clés trouvées sont présentes dans le résultat
var_dump($yac->get(array("foo", "foo2", "missing")));
// array(2) { ["foo"]=> string(3) "bar" ["foo2"]=> string(4) "bar2" }
?>

Voir aussi