Получает переменную, хранящуюся в пользовательском кеше

# wincache_ucache_get

(PECL wincache >= 1.1.0)

wincache_ucache_get — Получает переменную, хранящуюся в пользовательском кеше

### Описание

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

Получает переменную, хранящуюся в пользовательском кеше.

### Список параметров

`key`

  Параметр `key`, который использовался для хранения переменной в кеше. `key` чувствителен к регистру. `key` может быть массивом ключей. В этом случае возвращаемое значение будет массивом значений каждого элемента в массиве `key`. Если возвращается объект или массив, содержащий объекты, то объекты будут десериализованы. Подробнее о десериализации объектов смотрите __wakeup().

`success`

  Будет установлено значение `true` в случае успешного выполнения или `false` в случае возникновения ошибки.

### Возвращаемые значения

Если параметр `key` является строкой, функция возвращает значение переменной, хранящейся с этим ключом. Для параметра `success` будет установлено значение `true` в случае успешного выполнения или `false` в случае возникновения ошибки.

Если параметр `key` - это массив, параметр `success` всегда будет иметь значение `true`. Возвращённый массив (пары имя => значение) будет содержать только те пары имя => значение, для которых операция получения в пользовательском кеше была успешной. Если ни один из ключей в массиве ключей не находит совпадения в пользовательском кеше, будет возвращён пустой массив.

### Примеры

Пример #1 wincache_ucache_get() с `key` в виде строки

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

Результат выполнения приведённого примера:

    string(4) "blue"
    bool(true)

Пример #2 wincache_ucache_get() с `key` в виде массива

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

Результат выполнения приведённого примера:

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

### Смотрите также

- wincache_ucache_add() - Добавляет переменную в пользовательский кеш, только если кеш ещё не содержит переменную
- wincache_ucache_set() - Добавляет или перезаписывает переменную в пользовательский кеш
- wincache_ucache_delete() - Удаляет переменные из пользовательского кеша
- wincache_ucache_clear() - Удаляет всё содержимое пользовательского кеша
- wincache_ucache_exists() - Проверяет, существует ли переменная в пользовательском кеше
- wincache_ucache_meminfo() - Получает информацию об использовании памяти пользовательского кеша
- wincache_ucache_info() - Получает информацию о данных, хранящихся в пользовательском кеше
- __wakeup()

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