レコードを書き込む

# 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

### 参考

- TokyoTyrant::put() - 値を格納する
- TokyoTyrant::putCat() - レコードを連結する