# wincache_ucache_get

(PECL wincache >= 1.1.0)

wincache_ucache_get — Récupère une variable stokée dans le cache utilisateur

### Description

wincache_ucache_get(mixed `$key`, bool `&$success` = ?): mixed

Récupère une variable stokée dans le cache utilisateur.

### Liste de paramètres

`key`

  La clé `key` utilisée pour stoker la variable dans le cache. Le paramètre `key` est sensible à la casse. `key` peut être un tableau de clés. Dans ce cas, la valeur retournée sera un tableau de valeurs de chaque éléments du tableau `key`. Si un objet ou un tableau contenant des objets est retourné, alors les objets seront désérialisés. Reportez-vous à la fonction __wakeup() pour plus de détails sur les désérialisation des objets.

`success`

  Sera définie à `true` en cas de succès, `false` si une erreur survient.

### Valeurs de retour

Si le paramètre `key` est une chaîne de caractères, la fonction retournera la valeur de la variable stokée avec cette clé. Le paramètre `success` sera défini à `true` en cas de succès, et à `false` si une erreur survient.

Si le paramètre `key` est un tableau, le paramètre `success` sera toujours défini à `true`. Le tableau retourné (paires de nom => valeur) contiendra uniquement les paires nom => valeur pour lesquelles la récupération depuis le cache utilisateur a été un succès. Si aucune des clés du tableau ne correspond à des entrées du cache utilisateur, un tableau vide sera retourné.

### Exemples

Exemple #1 Exemple avec wincache_ucache_get() et le paramètre `key` sous forme de chaîne de caractères

`<?php
wincache_ucache_add('color', 'blue');
var_dump(wincache_ucache_get('color', $success));
var_dump($success);
?>`

L'exemple ci-dessus va afficher :

    string(4) "blue"
    bool(true)

Exemple #2 Exemple avec wincache_ucache_get() et le paramètre `key` sous forme d'un tableau

`<?php
$array1 = array('green' => '5', 'Blue' => '6', 'yellow' => '7', 'cyan' => '8');
wincache_ucache_set($array1);
$array2 = array('green', 'Blue', 'yellow', 'cyan');
var_dump(wincache_ucache_get($array2, $success));
var_dump($success);
?>`

L'exemple ci-dessus va afficher :

    array(4) { ["green"]=> string(1) "5"
               ["Blue"]=> string(1) "6"
               ["yellow"]=> string(1) "7"
               ["cyan"]=> string(1) "8" }
    bool(true)

### Voir aussi

- wincache_ucache_add() - Ajoute une nouvelle variable au cache utilisateur
- wincache_ucache_set() - Ajoute une variable au cache utilisateur et écrase la variable si elle existe déjà dans le cache
- wincache_ucache_delete() - Supprime les variables du cache utilisateur
- wincache_ucache_clear() - Supprime le contenu d'une entrée du cache utilisateur
- wincache_ucache_exists() - Vérifie si une variable existe dans le cache utilisateur
- wincache_ucache_meminfo() - Récupère des informations sur l'utilisation mémoire du cache utilisateur
- wincache_ucache_info() - Récupère des informations sur des données stokées dans le cache utilisateur
- __wakeup()