<?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="itoa" module="max" category="Lists">
	<digest>
		Convert integers to UTF-8 (Unicode) characters
	</digest>
	<description>
		Converts a stream or list of up to 256 integers into a symbol.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Lists
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				Integer list converted to symbol, bang outputs current symbol
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				Integer list converted and concatenated to current symbol
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="2" type="INLET_TYPE">
			<digest>
				Integer list converted and sets contents of symbol
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Symbol output
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg id="0" name="OBJARG_NAME" type="OBJARG_TYPE" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Send currently stored values as a symbol
			</digest>
			<description>
				In left inlet: a <m>bang</m> message can be used to trigger the output of the currently stored string of ascii characters as a symbol.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				In left inlet: The integer is interpreted as an ASCII character which is stored internally and sent out the outlet as a symbol.
				<br />
				<br />
				In middle inlet: The integer is interpreted as an ASCII character which is appended to the internally stored character string. No output is triggered.
				<br />
				<br />
				In right inlet: The integer is interpreted as an ASCII character which is stored internally, replacing the previously stored character string, but not output.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="input" optional="0" type="float" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				Converted to <m>int</m>.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Function depends on inlet
			</digest>
			<description>
				In left inlet: Each value in list of integers sent to the left inlet is interpreted as an ASCII character and stored internally as an ASCII character string, replacing the previously stored character string, and output as a symbol.
				<br />
				<br />
				In middle inlet: A list of integers sent to the middle inlet will be converted to ASCII characters and appended to the current internally-stored character string, without causing output.
				<br />
				<br />
				In right inlet: A list of integers sent to the right inlet will be converted to ASCII characters and stored internally as an ASCII character string, replacing the previously stored character string, without triggering output <m>.</m> 
			</description>
		</method>
		<method name="clear">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Clear stored values
			</digest>
			<description>
				In left inlet: The <m>clear</m> message is used to clear the contents of the internally-stored string of ascii characters.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="itoa.png" caption="Collect typed keys into a symbol (output with return key)." />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="atoi" />
		<seealso name="key" />
		<seealso name="keyup" />
		<seealso name="message" />
		<seealso name="regexp" />
		<seealso name="spell" />
		<seealso name="sprintf" />
		<seealso name="basicchapter08" module="max" type="tutorial" />
		<seealso name="communicationschapter02" module="max" type="tutorial" />
	</seealsolist>
	<discussion>
		This can be useful for formatting sysex bytes into a message for display purposes. The leftmost inlet accepts either a list of integers or an individual int, and immediately translates and transmits them/it. It also responds to <m>bang</m>, outputting the currently stored symbol. The rightmost inlet is used to set the output symbol, but unlike the left inlet it does not cause output. The middle inlet appends characters to the currently-stored symbol, either by list or one character at a time.
	</discussion>
	<misc name="Output">
		<entry name="symbol">
			<description>
				The ASCII character string converted from the input is sent out as a symbol.
			</description>
		</entry>
	</misc>
</c74object>
