TokyoTyrant::putKeep()

(PECL tokyo_tyrant >= 0.1.0)

Puts a record

说明

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

Puts a key-value pair into the database or multiple key-value pairs. If$keysis string then the second parameter value defines the value. The second parameter is mandatory if$keysis a string. If the key already exists this method throws an exception indicating that the records exists.

参数

$keys

A string key or an array of key-value pairs

$value

The string value

返回值

This method returns a reference to the current object and throws TokyoTyrantException on failure.

范例

Example #1 tokyotyrant::putKeep() example

<?php
/* Connect to a database on default port */
$tt = new TokyoTyrant("localhost");
/* Create a new key */
$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() Puts values
• TokyoTyrant::putCat() Concatenates to a record