<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Concatenates to a row</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="tokyotyranttable.put.html">TokyoTyrantTable::put</a></div>
<div class="next" style="text-align: right; float: right;"><a href="tokyotyranttable.putkeep.html">TokyoTyrantTable::putKeep</a></div>
<div class="up"><a href="class.tokyotyranttable.html">TokyoTyrantTable</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="tokyotyranttable.putcat" class="refentry">
<div class="refnamediv">
<h1 class="refname">TokyoTyrantTable::putCat</h1>
<p class="verinfo">(PECL tokyo_tyrant >= 0.1.0)</p><p class="refpurpose"><span class="refname">TokyoTyrantTable::putCat</span> — <span class="dc-title">Concatenates to a row</span></p>
</div>
<div class="refsect1 description" id="refsect1-tokyotyranttable.putcat-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="modifier">public</span> <span class="type"><span class="type void">void</span></span> <span class="methodname"><strong>TokyoTyrantTable::putCat</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$key</code></span>
, <span class="methodparam"><span class="type">array</span> <code class="parameter">$columns</code></span>
)</div>
<p class="para rdfs-comment">
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.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-tokyotyranttable.putcat-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">key</code></em></span>
<dd>
<p class="para">
The primary key of the row or <strong><code>NULL</code></strong>
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">columns</code></em></span>
<dd>
<p class="para">
Array of row contents
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-tokyotyranttable.putcat-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns the primary key and throws TokyoTyrantException on error.
</p>
</div>
<div class="refsect1 examples" id="refsect1-tokyotyranttable.putcat-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-2228">
<p><strong>Example #1 <span class="methodname"><strong>TokyoTyrantTable::putCat()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #FF8000">/* Connect to a table database */<br /></span><span style="color: #0000BB">$tt </span><span style="color: #007700">= new </span><span style="color: #0000BB">TokyoTyrantTable</span><span style="color: #007700">(</span><span style="color: #DD0000">"localhost"</span><span style="color: #007700">, </span><span style="color: #0000BB">1979</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">/* Passing null to put generates a new uid */<br /></span><span style="color: #0000BB">$index </span><span style="color: #007700">= </span><span style="color: #0000BB">$tt</span><span style="color: #007700">-></span><span style="color: #0000BB">put</span><span style="color: #007700">(</span><span style="color: #0000BB">null</span><span style="color: #007700">, array(</span><span style="color: #DD0000">"column1" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"some data"</span><span style="color: #007700">, </span><span style="color: #DD0000">"column2" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"more data"</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/* Get the row back */<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$tt</span><span style="color: #007700">-></span><span style="color: #0000BB">get</span><span style="color: #007700">(</span><span style="color: #0000BB">$index</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/* Modify an existing row */<br /></span><span style="color: #0000BB">$tt</span><span style="color: #007700">-></span><span style="color: #0000BB">putcat</span><span style="color: #007700">(</span><span style="color: #0000BB">$index</span><span style="color: #007700">, array(</span><span style="color: #DD0000">"column1" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"something new"</span><span style="color: #007700">, </span><span style="color: #DD0000">"new_column" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"other data"</span><span style="color: #007700">));<br /><br /></span><span style="color: #FF8000">/* Get the row back */<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$tt</span><span style="color: #007700">-></span><span style="color: #0000BB">get</span><span style="color: #007700">(</span><span style="color: #0000BB">$index</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
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"
}
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-tokyotyranttable.putcat-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="methodname"><a href="tokyotyranttable.put.html" class="methodname" rel="rdfs-seeAlso">TokyoTyrantTable::put()</a> - Store a row</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="tokyotyranttable.put.html">TokyoTyrantTable::put</a></div>
<div class="next" style="text-align: right; float: right;"><a href="tokyotyranttable.putkeep.html">TokyoTyrantTable::putKeep</a></div>
<div class="up"><a href="class.tokyotyranttable.html">TokyoTyrantTable</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
