<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="combine" module="max" category="Data">
	<digest>
		Combine multiple items into a single symbol
	</digest>
	<description>
		Combines a list of items into a single symbol. It works similar to <o>pack</o> and <o>sprintf</o>. The behavior can be modified with attributes that provide number padding and triggered output.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Data
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				(0)
			</digest>
			<description>
				First element to be formatted into the combined symbol.
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				$0 (1)
			</digest>
			<description>
				Second element to be formatted into the combined symbol.
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				merged output
			</digest>
			<description>
				Merged output.
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				dumpout
			</digest>
			<description>
				dumpout
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="inlets" optional="1" type="anything">
			<digest>
				Number of inlets
			</digest>
			<description>
				The number of inlets is determined by the number of arguments. Each argument sets an initial type and value for an item in the list stored by the <o>combine</o> object. If a number argument contains a decimal point, that item will be stored as a float. If the argument is a symbol, that item will be stored as a symbol.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Output stored and formatted symbol
			</digest>
			<description>
				Causes <o>combine</o> to send out a list of the items currently stored.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Store data and format output
			</digest>
			<description>
				The number is stored in <o>combine</o> as an item in a list, with its position in the list corresponding to the inlet in which it was received. The combined output is then generated from this list and sent out the outlet.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Store data and format output
			</digest>
			<description>
				The number is stored in <o>combine</o> as an item in a list, with its position in the list corresponding to the inlet in which it was received. The combined output is then generated from this list and sent out the outlet.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Store data and format output
			</digest>
			<description>
				When a list is sent into any inlet of the <o>combine</o> object, each item in the list is converted to symbols and stored. Its position in the list corresponds to the inlet in which it was received. If the list is sent to the left inlet, the combined output is then generated and sent out the outlet.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Store data and format output
			</digest>
			<description>
				The symbol is stored in <o>combine</o> as an item in a list, with its position in the list corresponding to the inlet in which it was received. The combined output is then generated from this list and sent out the outlet.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="padding" get="1" set="1" type="int" size="256">
			<digest>
				Numeric padding
			</digest>
			<description>
				A list that determines the number of zeros to add to a number if appropriate.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Padding" />
			</attributelist>
		</attribute>
		<attribute name="triggers" get="1" set="1" type="int" size="256">
			<digest>
				Trigger inputs
			</digest>
			<description>
				Define a list of inputs that will automatically trigger output (i.e. adding an input to this list will make the inlet &quot;hot&quot;). Setting the attribute value to -1 will cause the object to trigger output for any inlet (all inlets will be &quot;hot&quot;).
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Triggers" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="combine.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="join" />
		<seealso name="pack" />
		<seealso name="pak" />
		<seealso name="sprintf" />
		<seealso name="transport" />
	</seealsolist>
</c74object>
