Function xml.parse() - Revision history

Jturon at 17:20, 5 May 2017

2017-05-05T17:20:10Z

Jturon: /* XmlElement child(string name) */

2017-04-24T13:13:28Z

‎XmlElement child(string name)

Jturon: /* XmlAttribute/nil get(string/number...) */

2017-04-24T13:12:56Z

‎XmlAttribute/nil get(string/number...)

Jturon: /* string innerXml */

2017-04-22T13:23:42Z

‎string innerXml

Jturon: /* string xml */

2017-04-22T13:23:28Z

‎string xml

Jturon at 09:59, 22 April 2017

2017-04-22T09:59:07Z

Jturon at 09:54, 22 April 2017

2017-04-22T09:54:03Z

Jturon: /* XmlElement Members */

2017-04-22T09:53:14Z

‎XmlElement Members

Jturon: /* XmlElement Members */

2017-04-22T09:43:40Z

‎XmlElement Members

Jturon: /* XmlElement Members */

2017-04-21T17:17:21Z

‎XmlElement Members

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:function xml.check()}}
 Parses xml string.
-  <i>XmlElement</i> <b>xml.parse</b>(<code>xmlstring</code>)
+  <i>XmlElement</i> <b>xml.parse</b>(<i>string</i> <code>xml</code>)
 === Parameters ===
-* <i>string</i> <code>xmlstring</code> string to parse
+* <i>string</i> <code>xml</code> string to parse
 === Return value ===

@@ Line 33: / Line 33: @@
   logf("%s -> %s", attrs.from, attrs["to"]) -- ann -> bob
-=== <i>XmlElement</i> <code>child(<i>string</i> name)</code> ===
+=== <i>XmlElement/nil</i> <code>child(<i>string</i> name)</code> ===
-returns first child node with given name
+returns first child node with given name, nil if no such element is found
   local data = [[
     <papers>

@@ Line 58: / Line 58: @@
   log(parsed.children()[2].text) -- Automoto Revue
-===<i>XmlAttribute/nil</i> <code>get(<i>string/number</i>...)</code> ===
+===<i>XmlElement/nil</i> <code>get(<i>string/number</i>...)</code> ===
 traverses the xml tree and filters the result for each argument:
 * <i>string</i> descend into first node of given name

@@ Line 112: / Line 112: @@
   local parsed = xml.parse(data)
   log(parsed.innerXml)
--- <book>Bible</book> <magazine>Automoto Revue</magazine> <book>Quran</book>
+ -- <book>Bible</book> <magazine>Automoto Revue</magazine> <book>Quran</book>
 === <i>XmlElement/nil</i> <code>parent</code> ===

@@ Line 99: / Line 99: @@
   local parsed = xml.parse(data)
   log(parsed.child("book").xml)
--- <book>Bible</book> <magazine>Automoto Revue</magazine> <book>Quran</book>
+ -- <book>Bible</book> <magazine>Automoto Revue</magazine> <book>Quran</book>
 === <i>string</i> <code>innerXml</code> ===

@@ Line 11: / Line 11: @@
 Consecutive spaces are trimmed to single space.
-=== XmlElement Members ===
+== XmlElement ==
-* <i>string</i> <code>name</code> name of the node
   log(xml.parse("<note>something</note>").name) -- note
-* <i>string</i> <code>text</code> text content of the node (excluding the contents of child nodes). To read all content as a text, use .innerXml (see below)
   local data = xml.parse("<note>something &lt;big>really&lt;/big> good</note>")
   log(data.text) -- something good
-* <i>string/nil</i> <code>attr(<i>string</i> name)</code> returns the value of a single attribute; if the attribute doesn't exists, ruturns <i>nil</i>
   local data = xml.parse('<note from="ann" to="bob">hello</note>')
   log(data.attr("from")) -- ann
-* <i>table</i> <code>attr()</code> returns all attributes as a table
   local data = xml.parse('<note from="ann" to="bob">hello</note>')
   local attrs = data.attr()
   logf("%s -> %s", attrs.from, attrs["to"]) -- ann -> bob
-* <i>XmlElement</i> <code>child(<i>string</i> name)</code> returns first child node with given name
   local data = [[
     <papers>
@@ Line 34: / Line 44: @@
   local parsed = xml.parse(data)
   log(parsed.child("book").text) -- Bible
-* <i>array</i> <code>children(optional <i>string</i> name)</code> returns all child nodes; if name is provided, the nodes are filtered by the name
   local data = [[
     <papers>
@@ Line 45: / Line 57: @@
   log(parsed.children("book")[2].text) -- Quran
   log(parsed.children()[2].text) -- Automoto Revue
-* <i>XmlAttribute/nil</i> <code>get(<i>string/number</i>...)</code> traverses the xml tree and filters the result for each argument:
-** <i>string</i> descend into first node of given name
+===<i>XmlAttribute/nil</i> <code>get(<i>string/number</i>...)</code> ===
-** <i>number</i> descend into n-th node of name specified by previous argument
+traverses the xml tree and filters the result for each argument:
   local data = [[
   <root>
@@ Line 61: / Line 75: @@
   local parsed = xml.parse(data)
   log(parsed.get("papers",2,"book").text) -- Quran
-* <i>XmlElement/nil</i> <code>next</code> next sibling node of the same name
   local data = [[
     <papers>
@@ Line 71: / Line 87: @@
   local parsed = xml.parse(data)
   log(parsed.child("book").next.text) -- Quran
-* <i>string</i> <code>xml</code> inner xml of parent XmlElement
   local data = [[
     <papers>
@@ Line 82: / Line 100: @@
   log(parsed.child("book").xml)
 -- <book>Bible</book> <magazine>Automoto Revue</magazine> <book>Quran</book>
-* <i>string</i> <code>innerXml</code> inner xml of parent XmlElement
   local data = [[
     <papers>
@@ Line 93: / Line 113: @@
   log(parsed.innerXml)
 -- <book>Bible</book> <magazine>Automoto Revue</magazine> <book>Quran</book>
-* <i>XmlElement/nil</i> <code>parent</code> parent node
   local data = [[
     <papers>
@@ Line 103: / Line 125: @@
   local magazine = xml.parse(data).child("magazine")
   log(magazine.parent.name) -- papers
-* <i>XmlElement/nil</i> <code>root</code> root node (nil for root)

← Older revision		Revision as of 09:54, 22 April 2017
Line 104:		Line 104:
	log(magazine.parent.name) -- papers		log(magazine.parent.name) -- papers
	* <i>XmlElement/nil</i> <code>root</code> root node (nil for root)		* <i>XmlElement/nil</i> <code>root</code> root node (nil for root)
−	~~__NOTOC__~~