TokyoTyrant::putKeep

(PECL tokyo_tyrant >= 0.1.0)

TokyoTyrant::putKeep — レコードを書き込む

説明

public TokyoTyrant::putKeep ( mixed $keys [, string $value ] ) : TokyoTyrant

key-value ペアをデータベースに格納します。keys が文字列の場合は、二番目のパラメータ value で値を指定します。 keys が文字列の場合は二番目のパラメータは必須です。 指定したキーがすでに存在する場合は、すでにレコードが存在するという例外をスローします。

パラメータ

keys

文字列のキー、あるいは key-value ペアの配列。

value

文字列の値。

返り値

現在のオブジェクトへの参照を返します。失敗した場合は TokyoTyrantException をスローします。

例

例1 tokyotyrant::putKeep() の例

<?php
/* データベースのデフォルトポートに接続します */
$tt = new TokyoTyrant("localhost");

/* 新しいキーを作成します */
$tt->put("key", "value");

try {
    $tt->putKeep("key", "new value");
} catch (TokyoTyrantException $e) {
    if ($e->getCode() === TokyoTyrant::TTE_KEEP) {
        echo "Existing record! Not modified\n";
    } else {
        echo "Error: " , $e->getMessage() , "\n"; 
    }
}
echo $tt->get("key");
?>

上の例の出力は以下となります。

Existing record! Not modified
value

参考