文字

TokyoTyrant::putKeep

(PECL tokyo_tyrant >= 0.1.0)

TokyoTyrant::putKeepPuts a record

说明

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

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.

范例

Example #1 tokyotyrant::putKeep() example

<?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() - Puts values
  • TokyoTyrant::putCat() - Concatenates to a record
上一篇: 下一篇: