TokyoTyrant::putKeep
(PECL tokyo_tyrant >= 0.1.0)
TokyoTyrant::putKeep — Puts a record
Описание
Puts a key-value pair into the database or multiple key-value pairs. If keys
is
string then the second parameter value defines the value.
The second parameter is mandatory if keys
is 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.
Примеры
Пример #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