wincache_ucache_get

(PECL wincache >= 1.1.0)

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

Descripción

mixed wincache_ucache_get ( mixed $key [, bool &$success ] )

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()