(PECL tokyo_tyrant >= 0.1.0)
TokyoTyrantTable::putCat — Concatène une ligne
$key
, array $columns
) : void
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.
key
La clé primaire de la ligne, ou NULL
.
columns
Tableau contenant les données des lignes
Retourne la clé primaire et lance une exception TokyoTyrantException si une erreur survient.
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" }