サーバーから項目を取得する

# Memcache::get

# memcache_get

(PECL memcache >= 0.2.0)

Memcache::get -- memcache_get — サーバーから項目を取得する

### 説明

function Memcache::get(string `$key`, int `&$flags` = ?): string
function Memcache::get(array `$keys`, array `&$flags` = ?): array
function memcache_get(Memcache `$memcache`, string `$key`, int `&$flags` = ?): string
function memcache_get(Memcache `$memcache`, array `$keys`, array `&$flags` = ?): array

その時点でサーバー上の `key` にそのようなキーが存在する場合、 Memcache::get() は、前に格納されていたデータを返します。

Memcache::get() にキーの配列を渡すことにより、 値の配列を取得することができます。この配列には、サーバー上で見つかった キーと値のペアのみが含まれます。

### パラメータ

`key`
  取得したいキー (あるいはキーの配列)。
`flags`
  存在した場合は、値とともに取得したフラグをここに書き込みます。 これらのフラグは、たとえば Memcache::set() に渡すものと同じです。int の最下位バイトは pecl/memcache で内部的に使用するために予約されています (たとえば圧縮やシリアライズに関する状態を表します)。

### 戻り値

`key` に関連付けられた値を返します。 `key` が配列の場合は、 見つかったキー・値のペアを配列で返します。 取得に失敗したり `key` が見つからなかったり、 あるいは `key` が空だったりした場合は `false` を返します。

### 例

例1 Memcache::get() の例

    <?php

    /* 手続き型の API */
    $memcache_obj = memcache_connect('memcache_host', 11211);
    $var = memcache_get($memcache_obj, 'some_key');

    /* オブジェクト指向の API */
    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);
    $var = $memcache_obj->get('some_key');

    /*
    キーの配列をパラメータとして使用することもできます。
    もしキーに対応する項目がサーバー上で見つからなければ、
    結果の配列の中にはそのキーは含まれません。
    */

    /* 手続き型の API */
    $memcache_obj = memcache_connect('memcache_host', 11211);
    $var = memcache_get($memcache_obj, Array('some_key', 'another_key'));

    /* オブジェクト指向の API */
    $memcache_obj = new Memcache;
    $memcache_obj->connect('memcache_host', 11211);
    $var = $memcache_obj->get(Array('some_key', 'second_key'));

    ?>

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