TokyoTyrant::putKeep()
(PECL tokyo_tyrant >= 0.1.0)
Puts a record
说明
public TokyoTyrant::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