<doc>
	<legacy_id>1345</legacy_id>
	<name>revXMLChildNames</name>
	<type>function</type>

	<syntax>
		<example>revXMLChildNames(<i>treeID</i>, <i>startNode</i>, <i>nameDelim</i>, <i>childName</i>, <i>includeChildCount, </i>[incText])</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary><glossary tag="return">Returns</glossary> a list of the <glossary tag="child node">child nodes</glossary> under the specified <glossary tag="node">node</glossary> in an <glossary tag="XML tree">XML tree</glossary>.</summary>

	<examples>
<example>revXMLChildNames(1,the currNode of me,comma,,false)</example>
<example>get revXMLChildNames(currTree,line 2 of theNodes,return,"Grass",true)</example>
	</examples>

	<history>
		<introduced version="2.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
		<disk/>
	</security>


	<classification>
		<category>Text and Data Processing</category>
		<category>Standalone Applications</category>
	</classification>

	<references>
		<function tag="revXMLFirstChild">revXMLFirstChild Function</function>
		<function tag="revXMLText">revXMLText Function</function>
		<function tag="revXMLNumberOfChildren">revXMLNumberOfChildren Function</function>
		<function tag="revXMLMatchingNode">revXMLMatchingNode Function</function>
	</references>

	<description>
	<overview>Use the <b>revXMLChildNames</b> <control_st tag="function">function</control_st> to find out what <glossary tag="child node">child nodes</glossary> are under a <glossary tag="parent node">parent node</glossary>.</overview>

		<parameters>
<parameter>
<name>treeID</name>
<description>The number returned by the revXMLCreateTree or revXMLCreateTreeFromFile function when you created the XML tree.</description>
</parameter>
<parameter>
<name>startNode</name>
<description>The path to the node whose child nodes you want to list.</description>
</parameter>
<parameter>
<name>nameDelim</name>
<description>The string that separates each child node's name from the rest.</description>
</parameter>
<parameter>
<name>childName</name>
<description>The string specifying which child nodes to list. If it is empty, all child nodes are listed. Otherwise, only child nodes whose name matches the childName are listed.</description>
</parameter>
<parameter>
<name>includeChildCount</name>
<description>Either true or false. If the includeChildCount is true, each node's name is followed by the number of children it has, in brackets.</description>
</parameter>		</parameters>

	<value>The <b>revXMLChildNames</b> <control_st tag="function">function</control_st> returns a string.</value>
	<comments>If the <b>revXMLChildNames</b> <control_st tag="function">function</control_st> encounters an error, it <glossary tag="return">returns</glossary> an error message starting with "xmlerr".<p></p><p></p><note>If the <b>incText</b> form is specified and is true the function will return text nodes in processing. Text nodes can be accessed using the revXMLNodeContents function with the extended path format where text only nodes are numerically indexed eg summary/command/[1] is the first text node of the summary/command node.  </note><p></p><important>The <b>incText</b> form is experimental.</important><p></p><p></p><important>The <b>revXMLChildNames</b><control_st tag="function">function</control_st> is part of the <glossary tag="XML library">XML library</glossary>. To ensure that the <control_st tag="function">function</control_st> works in a <glossary tag="standalone application">standalone application</glossary>, you must include this <glossary tag="LiveCode custom library">custom library</glossary> when you create your <glossary tag="standalone application">standalone</glossary>. In the Inclusions section on the General screen of the <glossary tag="Standalone Application Settings">Standalone Application Settings</glossary> window, make sure "XML Library" is selected in the list of script libraries.</important></comments>
	</description>
</doc>