PHP Portal » PHP Handbuch » TokyoTyrant::putKeep

Werbung

TokyoTyrant::putKeep


(PECL tokyo_tyrant >= 0.1.0)

TokyoTyrant::putKeepPuts a record

Beschreibung

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.

Parameter-Liste

keys

A string key or an array of key-value pairs

value

The string value

Rückgabewerte

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

Beispiele

PHP Code
1
2
3
4
5
6
7
8
9
10
11
12
13
14
/* 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");

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Existing record! Not modified
value

Siehe auch