<?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="spell" module="max" category="Data">
	<digest>
		Convert input to UTF-8 (Unicode) codes
	</digest>
	<description>
		Accepts a numeric stream and outputs and outputs ASCII characters. Options arguments provide for forced-length messages.
	</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>
				Symbol to be Spelled
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				Symbol to be Spelled
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Symbol's Characters, As Integers
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="size" optional="1" type="int">
			<digest>
				Minimum output size
			</digest>
			<description>
				Sets the minimum output size. Any input that doesn't &quot;spell&quot; to the minimum length is followed by enough fill characters (the default is the space character, 32 in ASCII) to satisfy the minimum requirement.
			</description>
		</objarg>
		<objarg name="character" optional="1" type="int">
			<digest>
				Minimum output size
			</digest>
			<description>
				Specifies the fill character to use instead of 32. If you want to use '0' as a fill character, use any negative number as a second argument to <o>spell</o>.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Convert to ASCII
			</digest>
			<description>
				The ASCII value of each of the digits of the number is sent out the outlet, one digit at a time.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Convert all elements to ASCII
			</digest>
			<description>
				Each int in the list is converted to ASCII as described above, and a space character (32) is sent out between items in the list. Any float or symbol items in the list are ignored.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="input" optional="0" type="list" />
			</arglist>
			<digest>
				Convert input to ASCII
			</digest>
			<description>
				If the message begins with a symbol, all int and symbol items in the message are converted to ASCII one character at a time, and a space character (32) is placed between them. Any float items in the list are ignored. If the message begins with a float, both floats and symbols are ignored.
			</description>
		</method>
		<method name="symbol">
			<arglist>
				<arg name="input" optional="0" type="symbol" />
			</arglist>
			<digest>
				Convert all characters to ASCII
			</digest>
			<description>
				The ASCII value of each letter, digit, or other character in the symbol is sent out the outlet, one character at a time.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="spell.png" caption="Using the spell object, a modem command string or a synthesizer patch name can be translated from human terms into computer terms, and sent out the serial port in ASCII representation" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="atoi" />
		<seealso name="itoa" />
		<seealso name="key" />
		<seealso name="keyup" />
		<seealso name="message" />
		<seealso name="sprintf" />
	</seealsolist>
	<discussion>
		<o>spell</o> takes two optional arguments. The first is a minimum output size. The second is the UTF-8 number of a fill character to put between words and at the end of a word if it is less than the minimum output. The default minimum is 0 (none), and the default fill character is space (32), to use 0 as a fill character, supply a negative number as a second argument.
	</discussion>
	<misc name="Outputs">
		<entry name="int">
			<description>
				The ASCII representation of the input is sent out one character at a time.
			</description>
		</entry>
	</misc>
</c74object>
