XmlFindChild

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This function returns a named child node of an XML node.

Syntax

xmlnode xmlFindChild ( xmlnode parent, string tagName, int index )

OOP Syntax Help! I don't understand this!

Method: xmlnode:findChild(...)


Required Arguments

  • parent: This is an xmlnode that you want to find the child node under.
  • tagName: This is the name of the child node you wish to find (case-sensitive).
  • index: This is the 0-based index of the node you wish to find. For example, to find the 5th subnode with a particular name, you would use 4 as the index value. To find the first occurence, use 0.

Returns

Returns an xmlnode if the node was found, false otherwise.

Example

Click to collapse [-]
Server

If you wanted to find an instructions node in an xml file like this:

<root version="2.0">
      <options>
            <instructions>Start at the beginning and keep going until the end!</instructions>
      </options>
</root>

You could use the following code to print the text in the instructions node to the chatbox:

local rootNode = xmlLoadFile ( "test.xml" )
local optionsNode = xmlFindChild ( rootNode, "options", 0 )
local instructionsNode = xmlFindChild ( optionsNode, "instructions", 0 )
local instructions = xmlNodeGetValue ( instructionsNode )
xmlUnloadFile(rootNode)

outputChatBox ( instructions )

See Also