Concatenates to a row

TokyoTyrantTable::put
TokyoTyrantTable::putKeep
TokyoTyrantTable
PHP Manual

# TokyoTyrantTable::putCat

(PECL tokyo_tyrant >= 0.1.0)

TokyoTyrantTable::putCat — Concatenates to a row

### Description

public void TokyoTyrantTable::putCat ( string `$key` , array `$columns` )

This method can be used to add new columns to existing records. Existing keys will be left unmodified but any new columns will be appended to the row. Passing null as key will generate a new row.

### Parameters

`key`

  The primary key of the row or `NULL`

`columns`

  Array of row contents

### Return Values

Returns the primary key and throws TokyoTyrantException on error.

### Examples

Example #1 TokyoTyrantTable::putCat example

`<?php
/* Connect to a table database */
$tt = new TokyoTyrantTable("localhost", 1979);
/* Passing null to put generates a new uid */
$index = $tt->put(null, array("column1" => "some data", "column2" => "more data"));
/* Get the row back */
var_dump($tt->get($index));
/* Modify an existing row */
$tt->putcat($index, array("column1" => "something new", "new_column" => "other data"));
/* Get the row back */
var_dump($tt->get($index));
?>`

The above example will output:

    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"
    }

### See Also

- TokyoTyrantTable::put - Store a row

TokyoTyrantTable::put
TokyoTyrantTable::putKeep
TokyoTyrantTable
PHP Manual