<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE TIP SYSTEM "http://tcl.activestate.com/cgi-bin/tct/tip/tipxml.dtd">
<!-- Converted at Wed May 16 19:57:31 GMT 2012 -->
<!-- TIP AutoGenerator - written by Donal K. Fellows -->

<TIP number='163'>
<header><title>A [dict merge] Subcommand</title><author address="mailto:jenglish@users.sourceforge.net">Joe English</author><status type='project' state='final' tclversion="8.5" vote='after'>$Revision: 1.4 $</status><history></history><created day='14' month='nov' year='2003' /></header>
<abstract>This TIP proposes a new [dict] subcommand which is used to combine multiple dictionaries.</abstract>
<body><section title="Specification">
<verbatim><vline encoding='base64'>CWRpY3QgbWVyZ2UgJydkaWN0VmFsMScnICcnZGljdFZhbDInJyAnJy4uLicnICcnZGljdFZhbE4nJw==</vline></verbatim>
<para>Returns a new dictionary containing all the key/value pairs in <emph style="italic">dictVal1</emph> through <emph style="italic">dictValN</emph>. In the case of duplicate keys, values from later arguments override those from earlier ones.</para>
</section>
<section title="Implementation">
<para>See SF Patch #745851 <url ref="http://sourceforge.net/support/tracker.php?aid=745851"/></para>
</section>
<section title="Examples">
<para>See the EXAMPLES section of return(n), which currently reads:</para>
<verbatim><vline encoding='base64'>IHNldCBvcHRpb25zIFtldmFsIFtsaXN0IGRpY3QgY3JlYXRlIC1sZXZlbCAxXSAkYXJnc10=</vline></verbatim>
<para>This could be replaced with</para>
<verbatim><vline encoding='base64'>IHNldCBvcHRpb25zIFtkaWN0IG1lcmdlIHstbGV2ZWwgMX0gJGFyZ3Nd</vline></verbatim>
</section>
<section title="Notes">
<para>This feature was suggested during the discussion of <tipref type="text" tip="111"/>, but since the vote was already in progress it was not considered at that time.</para>
</section>
<section title="Copyright">
<para>This document has been placed in the public domain.</para>
</section>
</body></TIP>

