# wincache_ucache_get

(PECL wincache >= 1.1.0)

wincache_ucache_get — Obtiene una variable almacenada en la caché del usuario

### Descripción

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

Obtiene una variable almacenada en la caché del usuario.

### Parámetros

`key`

  La `key` que se utiliza para almacenar la variable en la caché. `key` distingue mayúsculas de minúsculas. `key` puede ser un array de claves. En este caso el valor de retorno será un array de valores de cada elemento en el array `key`. Si un objeto, o un array que contiene objetos, es retornado, entonces los objetos serán decodificados. Véase __wakeup() para más detalles sobre decodificar objetos.

`success`

  Se establecerá en `true` en caso de éxito y `false` en caso de error.

### Valores devueltos

Si `key` es un string, la función devuelve el valor de la variable almacenada con esa clave. El parámetro `success` es establecido a `true` en caso de éxito y a `false` en caso de error.

El parámetro `key` es un array, el parámetro `success` siempre se establece en `true`. El array devuelto (pares nombre => valor) will contendrá sólo aquellos pares nombre => valor en donde la operación de obtención de caché de usuario se ha realizado correctamente. Si ninguna de las claves del array encuentran una coincidencia en la caché del usuario, un array vacío será devuelto.

### Ejemplos

Ejemplo #1 wincache_ucache_get() con `key` como un string

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

El resultado del ejemplo sería:

    string(4) "blue"
    bool(true)

Ejemplo #2 wincache_ucache_get() con `key` como un array

`<?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);
?>`

El resultado del ejemplo sería:

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

### Ver también

- wincache_ucache_add() - Adds a variable in user cache only if variable does not already exist in the cache
- wincache_ucache_set() - Adds a variable in user cache and overwrites a variable if it already exists in the cache
- wincache_ucache_delete() - Elimina las variables de la memoria caché del usuario
- wincache_ucache_clear() - Elimina todo el contenido de la caché del usuario
- wincache_ucache_exists() - Comprueba si una variable existe en la caché del usuario
- wincache_ucache_meminfo() - Recupera información sobre el uso de memoria caché de usuario
- wincache_ucache_info() - Recupera información sobre los datos almacenados en la caché del usuario
- __wakeup()