Obtiene una variable almacenada en la caché del usuario

# wincache_ucache_get

(PECL wincache >= 1.1.0)

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

### Descripción

function 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) 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 ejemplo anterior mostrará:

    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 ejemplo anterior mostrará:

    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() - Añade una nueva variable al caché de usuario solo si la variable todavía no existe en el cache
- wincache_ucache_set() - Añade una variable a la caché de usuario y sobrescribe la variable si ya existe en la caché
- 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()

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open