TokyoTyrantTable::putCat

Concatenates to a row

&reftitle.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.

&reftitle.parameters;

`key`

- The primary key of the row or &null;

`columns`

- Array of row contents

&reftitle.returnvalues;

Returns the primary key and throws TokyoTyrantException on error.

&reftitle.examples;

### `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));
    ?>

&example.outputs;

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

&reftitle.seealso;

- `TokyoTyrantTable::put`