<?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="string.toarray" module="max" category="String">
	<digest>
		Construct a new array object from a string object.
	</digest>
	<description>
		Construct a new array object from a string object. An optional separator string can be used to determine how the string is split into individual array entries (default = &lt;space&gt;).
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			string
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				string in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				separator string in
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				array out
			</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>
				Trigger output
			</digest>
			<description>
				Reprocess previously received string and trigger output.
			</description>
		</method>
		<method name="int">
			<arglist>
				<arg name="ARG_NAME_0" type="int" optional="0" />
			</arglist>
			<digest>
				Convert an integer to a string.
			</digest>
			<description>
				Convert an incoming integer to a string, then process as described for the <m>string</m> message.
			</description>
		</method>
		<method name="float">
			<arglist>
				<arg name="ARG_NAME_0" type="float" optional="0" />
			</arglist>
			<digest>
				Convert a floating-point number to a string.
			</digest>
			<description>
				Convert an incoming floating-point number to a string, then process as described for the <m>string</m> message.
			</description>
		</method>
		<method name="list">
			<arglist>
				<arg name="ARG_NAME_0" type="list" optional="0" />
			</arglist>
			<digest>
				Convert a list to a string.
			</digest>
			<description>
				Convert an incoming list to a string, then process as described for the <m>string</m> message.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="ARG_NAME_0" type="list" optional="0" />
			</arglist>
			<digest>
				Convert a list to a string.
			</digest>
			<description>
				Convert an incoming list to a string, then process as described for the <m>string</m> message.
			</description>
		</method>
		<method name="clear">
			<arglist />
			<digest>
				Clear the separator string
			</digest>
			<description>
				Clear the separator string, so that the array will contain one element: the entire string. This is not the same as setting the separator to &quot;emptystring&quot;.
			</description>
		</method>
		<method name="string">
			<arglist>
				<arg name="ARG_NAME_0" type="list" optional="0" />
			</arglist>
			<digest>
				Create an array object from the string
			</digest>
			<description>
				In the right inlet, a string will be stored as the separator string. In the left inlet, the string will be stored and then split into array elements, using the separator string to determine the splits (the separator characters are excluded from the resulting elements). Finally, a new array containing individual string elements will be sent to the outlet.
				<br />
				<br />
				For instance, the string &quot;peas porridge in the pot&quot;, with a separator string of &quot; &quot;, will generate the array <m>[ &quot;peas&quot;, &quot;porridge&quot;, &quot;in&quot;, &quot;the&quot;, &quot;pot&quot; ]</m>, while a separator string of &quot; ;po&quot; would result in the array <m>[ &quot;peas&quot;, &quot;rridge in the&quot;, &quot;t&quot; ]</m>. The special separator value &quot;emptystring&quot; will separate on every character, resulting in an array where every element in a single character of the initial string.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example caption="" img="" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="string" />
		<seealso name="string.bytes" />
		<seealso name="string.frombytes" />
		<seealso name="string.fromsymlist" />
		<seealso name="string.fromutf8" />
		<seealso name="string.tolist" />
		<seealso name="string.utf8" />
	</seealsolist>
</c74object>
