TokyoTyrantTable::putCat
(PECL tokyo_tyrant >= 0.1.0)
TokyoTyrantTable::putCat — Concatène une ligne
Description
public void TokyoTyrantTable::putCat
( string
$key
, array $columns
)
Cette méthode peut être utilisée pour ajouter de nouvelles colonnes
à des enregistrements existantes. Les clés existantes ne seront
pas modifiées mais les nouvelles colonnes seront ajoutées à la ligne.
Le fait de passer la valeur NULL comme clé génèrera une nouvelle ligne.
Liste de paramètres
-
key -
La clé primaire de la ligne, ou
NULL. -
columns -
Tableau contenant les données des lignes
Valeurs de retour
Retourne la clé primaire et lance une exception TokyoTyrantException si une erreur survient.
Exemples
Exemple #1 Exemple avec TokyoTyrantTable::putCat()
<?php
/* Connexion à une base de données */
$tt = new TokyoTyrantTable("localhost", 1979);
/* Passage de la valeur null pour générer un nouvel identifiant unique */
$index = $tt->put(null, array("column1" => "some data", "column2" => "more data"));
/* Récupère la ligne précédente */
var_dump($tt->get($index));
/* Modification de la ligne existante */
$tt->putcat($index, array("column1" => "something new", "new_column" => "other data"));
/* Récupération de la ligne précédente */
var_dump($tt->get($index));
?>L'exemple ci-dessus va afficher :
array(2) {
["column1"]=>
string(9) "some data"
["column2"]=>
string(9) "more data"
}
array(3) {
["column1"]=>
string(9) "some data"
["column2"]=>
string(9) "more data"
["new_column"]=>
string(10) "other data"
}
