Начало Каталог Помощ
Вход
levovix
/
Nim
огледало от https://github.com/nim-lang/Nim
Наблюдаван 1
Харесван 0
Разклонения 1
Файлове Задачи 0 Уики
Клон: gh-pages
Клонове Маркери
Nim
/
xmltree.html

xmltree.html 165 KB
Постоянна връзка История Директен файл

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418 
  1. <?xml version="1.0" encoding="utf-8" ?>
    2. 

  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
    3. 

  3. <!--  This file is generated by Nim. -->
    4. 

  4. <html xmlns="https://www.w3.org/1999/xhtml" xml:lang="en" lang="en" data-theme="auto">
    5. 

  5. <head>
    6. 

  6. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    7. 

  7. <meta name="viewport" content="width=device-width, initial-scale=1.0">
    8. 

  8. <title>std/xmltree</title>
    9. 

  9. 

  10. <!-- Google fonts -->
    11. 

  11. <link href='https://fonts.googleapis.com/css?family=Lato:400,600,900' rel='stylesheet' type='text/css'/>
    12. 

  12. <link href='https://fonts.googleapis.com/css?family=Source+Code+Pro:400,500,600' rel='stylesheet' type='text/css'/>
    13. 

  13. 

  14. <!-- Favicon -->
    15. 

  15. <link rel="shortcut icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAUAAAAF////AP///wD///8A////AP///wD///8A////AP///wD///8A////AAAAAAIAAABbAAAAlQAAAKIAAACbAAAAmwAAAKIAAACVAAAAWwAAAAL///8A////AP///wD///8A////AAAAABQAAADAAAAAYwAAAA3///8A////AP///wD///8AAAAADQAAAGMAAADAAAAAFP///wD///8A////AP///wAAAACdAAAAOv///wD///8A////AP///wD///8A////AP///wD///8AAAAAOgAAAJ3///8A////AP///wAAAAAnAAAAcP///wAAAAAoAAAASv///wD///8A////AP///wAAAABKAAAAKP///wAAAABwAAAAJ////wD///8AAAAAgQAAABwAAACIAAAAkAAAAJMAAACtAAAAFQAAABUAAACtAAAAkwAAAJAAAACIAAAAHAAAAIH///8A////AAAAAKQAAACrAAAAaP///wD///8AAAAARQAAANIAAADSAAAARf///wD///8AAAAAaAAAAKsAAACk////AAAAADMAAACcAAAAnQAAABj///8A////AP///wAAAAAYAAAAGP///wD///8A////AAAAABgAAACdAAAAnAAAADMAAAB1AAAAwwAAAP8AAADpAAAAsQAAAE4AAAAb////AP///wAAAAAbAAAATgAAALEAAADpAAAA/wAAAMMAAAB1AAAAtwAAAOkAAAD/AAAA/wAAAP8AAADvAAAA3gAAAN4AAADeAAAA3gAAAO8AAAD/AAAA/wAAAP8AAADpAAAAtwAAAGUAAAA/AAAA3wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAADfAAAAPwAAAGX///8A////AAAAAEgAAADtAAAAvwAAAL0AAADGAAAA7wAAAO8AAADGAAAAvQAAAL8AAADtAAAASP///wD///8A////AP///wD///8AAAAAO////wD///8A////AAAAAIcAAACH////AP///wD///8AAAAAO////wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A////AP///wD///8A//8AAP//AAD4HwAA7/cAAN/7AAD//wAAoYUAAJ55AACf+QAAh+EAAAAAAADAAwAA4AcAAP5/AAD//wAA//8AAA=="/>
    16. 

  16. <link rel="icon" type="image/png" sizes="32x32" href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAA3XAAAN1wFCKJt4AAAAB3RJTUUH4QQQEwksSS9ZWwAAAk1JREFUWMPtll2ITVEUx39nn/O7Y5qR8f05wtCUUr6ZIS++8pEnkZInPImneaCQ5METNdOkeFBKUhMPRIkHKfEuUZSUlGlKPN2TrgfncpvmnntnmlEyq1Z7t89/rf9a6+y99oZxGZf/XeIq61EdtgKXgdXA0xrYAvBjOIF1AI9zvjcC74BSpndrJPkBWDScTF8Aa4E3wDlgHbASaANmVqlcCnwHvgDvgVfAJ+AikAAvgfVZwLnSVZHZaOuKoQi3ZOMi4NkYkpe1p4J7A8BpYAD49hfIy/oqG0+hLomiKP2L5L+1ubn5115S+3OAn4EnwBlgMzCjyt6ZAnQCJ4A7wOs88iRJHvw50HoujuPBoCKwHWiosy8MdfZnAdcHk8dxXFJ3VQbQlCTJvRBCGdRbD4M6uc5glpY3eAihpN5S5w12diSEcCCEcKUO4ljdr15T76ur1FDDLIQQ3qv71EdDOe3Kxj3leRXyk+pxdWnFWod6Wt2bY3de3aSuUHcPBVimHs7mK9WrmeOF6lR1o9qnzskh2ar2qm1qizpfXaPeVGdlmGN5pb09qMxz1Xb1kLqgzn1RyH7JUXW52lr5e/Kqi9qpto7V1atuUzfnARrV7jEib1T76gG2qxdGmXyiekkt1GswPTtek0aBfJp6YySGBfWg2tPQ0FAYgf1stUfdmdcjarbYJEniKIq6gY/Aw+zWHAC+p2labGpqiorFYgGYCEzN7oQdQClN07O1/EfDyGgC0ALMBdYAi4FyK+4H3gLPsxfR1zRNi+NP7nH5J+QntnXe5B5mpfQAAAAASUVORK5CYII=">
    17. 

  17. 

  18. <!-- CSS -->
    19. 

  19. <link rel="stylesheet" type="text/css" href="nimdoc.out.css?v=2.3.1">
    20. 

  20. 

  21. <!-- JS -->
    22. 

  22. <script type="text/javascript" src="dochack.js?v=2.3.1"></script>
    23. 

  23. </head>
    24. 

  24. <body>
    25. 

  25.   <div class="document" id="documentId">
    26. 

  26.     <div class="container">
    27. 

  27.       <h1 class="title">std/xmltree</h1>
    28. 

  28.       <div class="row">
    29. 

  29.   <div class="three columns">
    30. 

  30.     <div class="theme-select-wrapper">
    31. 

  31.       <label for="theme-select">Theme:&nbsp;</label>
    32. 

  32.       <select id="theme-select" onchange="setTheme(this.value)">
    33. 

  33.         <option value="auto">🌗 Match OS</option>
    34. 

  34.         <option value="dark">🌑 Dark</option>
    35. 

  35.         <option value="light">🌕 Light</option>
    36. 

  36.       </select>
    37. 

  37.     </div>
    38. 

  38.     <div id="global-links">
    39. 

  39.       <ul class="simple-boot">
    40. 

  40.         <li><a href="manual.html">Manual</a></li>
    41. 

  41.         <li><a href="lib.html">Standard library</a></li>
    42. 

  42.         <li> <a id="indexLink" href="theindex.html">Index</a></li>
    43. 

  43.         <li><a href="compiler/theindex.html">Compiler docs</a></li>
    44. 

  44.         <li><a href="https://nim-lang.github.io/fusion/theindex.html">Fusion docs</a></li>
    45. 

  45.         <li><a href="https://nim-lang.github.io/Nim/">devel</a>, <a href="https://nim-lang.org/documentation.html">stable</a></li>
    46. 

  46.       </ul>
    47. 

  47.     </div>
    48. 

  48.     <div id="searchInputDiv">
    49. 

  49.       Search: <input type="search" id="searchInput"
    50. 

  50.         oninput="search()" />
    51. 

  51.     </div>
    52. 

  52.     
    53. 

  53.     <ul class="simple simple-toc" id="toc-list">
    54. 

  54.   <li>
    55. 

  55.   <a class="reference reference-toplevel" href="#6" id="56">Imports</a>
    56. 

  56. </li>
    57. 

  57. <li>
    58. 

  58.   <details open>
    59. 

  59.     <summary><a class="reference reference-toplevel" href="#7" id="57">Types</a></summary>
    60. 

  60.     <ul class="simple simple-toc-section">
    61. 

  61.       <li><a class="reference" href="#XmlAttributes" title="XmlAttributes = StringTableRef">XmlAttributes</a></li>
    62. 

  62. <li><a class="reference" href="#XmlNode" title="XmlNode = ref XmlNodeObj">XmlNode</a></li>
    63. 

  63. <li><a class="reference" href="#XmlNodeKind" title="XmlNodeKind = enum
    64. 

  64.   xnText,                   ## a text element
    65. 

  65.   xnVerbatimText, xnElement, ## an element with 0 or more children
    66. 

  66.   xnCData,                  ## a CDATA node
    67. 

  67.   xnEntity,                 ## an entity (like ``&amp;thing;``)
    68. 

  68.   xnComment                  ## an XML comment">XmlNodeKind</a></li>
    69. 

  69. 

  70.     </ul>
    71. 

  71.   </details>
    72. 

  72. </li>
    73. 

  73. <li>
    74. 

  74.   <details open>
    75. 

  75.     <summary><a class="reference reference-toplevel" href="#10" id="60">Consts</a></summary>
    76. 

  76.     <ul class="simple simple-toc-section">
    77. 

  77.       <li><a class="reference" href="#xmlHeader" title="xmlHeader = &quot;&lt;?xml version=\&quot;1.0\&quot; encoding=\&quot;UTF-8\&quot; ?&gt;\n&quot;">xmlHeader</a></li>
    78. 

  78. 

  79.     </ul>
    80. 

  80.   </details>
    81. 

  81. </li>
    82. 

  82. <li>
    83. 

  83.   <details open>
    84. 

  84.     <summary><a class="reference reference-toplevel" href="#12" id="62">Procs</a></summary>
    85. 

  85.     <ul class="simple simple-toc-section">
    86. 

  86.       <ul class="simple nested-toc-section">$
    87. 

  87.   <li><a class="reference" href="#%24%2CXmlNode" title="`$`(n: XmlNode): string">`$`(n: XmlNode): string</a></li>
    88. 

  88. 

  89. </ul>
    90. 

  90. <ul class="simple nested-toc-section">[]
    91. 

  91.   <li><a class="reference" href="#%5B%5D%2CXmlNode%2Cint_2" title="`[]`(n: var XmlNode; i: int): var XmlNode">`[]`(n: var XmlNode; i: int): var XmlNode</a></li>
    92. 

  92. <li><a class="reference" href="#%5B%5D%2CXmlNode%2Cint" title="`[]`(n: XmlNode; i: int): XmlNode">`[]`(n: XmlNode; i: int): XmlNode</a></li>
    93. 

  93. 

  94. </ul>
    95. 

  95. <ul class="simple nested-toc-section">add
    96. 

  96.   <li><a class="reference" href="#add%2CXmlNode%2CXmlNode" title="add(father, son: XmlNode)">add(father, son: XmlNode)</a></li>
    97. 

  97. <li><a class="reference" href="#add%2CXmlNode%2CopenArray%5BXmlNode%5D" title="add(father: XmlNode; sons: openArray[XmlNode])">add(father: XmlNode; sons: openArray[XmlNode])</a></li>
    98. 

  98. <li><a class="reference" href="#add%2Cstring%2CXmlNode%2Cint%2Cint" title="add(result: var string; n: XmlNode; indent = 0; indWidth = 2; addNewLines = true)">add(result: var string; n: XmlNode; indent = 0; indWidth = 2; addNewLines = true)</a></li>
    99. 

  99. 

  100. </ul>
    101. 

  101. <ul class="simple nested-toc-section">addEscaped
    102. 

  102.   <li><a class="reference" href="#addEscaped%2Cstring%2Cstring" title="addEscaped(result: var string; s: string)">addEscaped(result: var string; s: string)</a></li>
    103. 

  103. 

  104. </ul>
    105. 

  105. <ul class="simple nested-toc-section">attr
    106. 

  106.   <li><a class="reference" href="#attr%2CXmlNode%2Cstring" title="attr(n: XmlNode; name: string): string">attr(n: XmlNode; name: string): string</a></li>
    107. 

  107. 

  108. </ul>
    109. 

  109. <ul class="simple nested-toc-section">attrs
    110. 

  110.   <li><a class="reference" href="#attrs%2CXmlNode" title="attrs(n: XmlNode): XmlAttributes">attrs(n: XmlNode): XmlAttributes</a></li>
    111. 

  111. 

  112. </ul>
    113. 

  113. <ul class="simple nested-toc-section">attrs=
    114. 

  114.   <li><a class="reference" href="#attrs%3D%2CXmlNode%2CXmlAttributes" title="attrs=(n: XmlNode; attr: XmlAttributes)">attrs=(n: XmlNode; attr: XmlAttributes)</a></li>
    115. 

  115. 

  116. </ul>
    117. 

  117. <ul class="simple nested-toc-section">attrsLen
    118. 

  118.   <li><a class="reference" href="#attrsLen%2CXmlNode" title="attrsLen(n: XmlNode): int">attrsLen(n: XmlNode): int</a></li>
    119. 

  119. 

  120. </ul>
    121. 

  121. <ul class="simple nested-toc-section">child
    122. 

  122.   <li><a class="reference" href="#child%2CXmlNode%2Cstring" title="child(n: XmlNode; name: string): XmlNode">child(n: XmlNode; name: string): XmlNode</a></li>
    123. 

  123. 

  124. </ul>
    125. 

  125. <ul class="simple nested-toc-section">clear
    126. 

  126.   <li><a class="reference" href="#clear%2CXmlNode" title="clear(n: var XmlNode)">clear(n: var XmlNode)</a></li>
    127. 

  127. 

  128. </ul>
    129. 

  129. <ul class="simple nested-toc-section">clientData
    130. 

  130.   <li><a class="reference" href="#clientData%2CXmlNode" title="clientData(n: XmlNode): int">clientData(n: XmlNode): int</a></li>
    131. 

  131. 

  132. </ul>
    133. 

  133. <ul class="simple nested-toc-section">clientData=
    134. 

  134.   <li><a class="reference" href="#clientData%3D%2CXmlNode%2Cint" title="clientData=(n: XmlNode; data: int)">clientData=(n: XmlNode; data: int)</a></li>
    135. 

  135. 

  136. </ul>
    137. 

  137. <ul class="simple nested-toc-section">delete
    138. 

  138.   <li><a class="reference" href="#delete%2CXmlNode%2CNatural" title="delete(n: XmlNode; i: Natural)">delete(n: XmlNode; i: Natural)</a></li>
    139. 

  139. <li><a class="reference" href="#delete%2CXmlNode%2CSlice%5Bint%5D" title="delete(n: XmlNode; slice: Slice[int])">delete(n: XmlNode; slice: Slice[int])</a></li>
    140. 

  140. 

  141. </ul>
    142. 

  142. <ul class="simple nested-toc-section">escape
    143. 

  143.   <li><a class="reference" href="#escape%2Cstring" title="escape(s: string): string">escape(s: string): string</a></li>
    144. 

  144. 

  145. </ul>
    146. 

  146. <ul class="simple nested-toc-section">findAll
    147. 

  147.   <li><a class="reference" href="#findAll%2CXmlNode%2Cstring" title="findAll(n: XmlNode; tag: string; caseInsensitive = false): seq[XmlNode]">findAll(n: XmlNode; tag: string; caseInsensitive = false): seq[XmlNode]</a></li>
    148. 

  148. <li><a class="reference" href="#findAll%2CXmlNode%2Cstring%2Cseq%5BXmlNode%5D" title="findAll(n: XmlNode; tag: string; result: var seq[XmlNode];
    149. 

  149.         caseInsensitive = false)">findAll(n: XmlNode; tag: string; result: var seq[XmlNode];
    150. 

  150.         caseInsensitive = false)</a></li>
    151. 

  151. 

  152. </ul>
    153. 

  153. <ul class="simple nested-toc-section">innerText
    154. 

  154.   <li><a class="reference" href="#innerText%2CXmlNode" title="innerText(n: XmlNode): string">innerText(n: XmlNode): string</a></li>
    155. 

  155. 

  156. </ul>
    157. 

  157. <ul class="simple nested-toc-section">insert
    158. 

  158.   <li><a class="reference" href="#insert%2CXmlNode%2CXmlNode%2Cint" title="insert(father, son: XmlNode; index: int)">insert(father, son: XmlNode; index: int)</a></li>
    159. 

  159. <li><a class="reference" href="#insert%2CXmlNode%2CopenArray%5BXmlNode%5D%2Cint" title="insert(father: XmlNode; sons: openArray[XmlNode]; index: int)">insert(father: XmlNode; sons: openArray[XmlNode]; index: int)</a></li>
    160. 

  160. 

  161. </ul>
    162. 

  162. <ul class="simple nested-toc-section">kind
    163. 

  163.   <li><a class="reference" href="#kind%2CXmlNode" title="kind(n: XmlNode): XmlNodeKind">kind(n: XmlNode): XmlNodeKind</a></li>
    164. 

  164. 

  165. </ul>
    166. 

  166. <ul class="simple nested-toc-section">len
    167. 

  167.   <li><a class="reference" href="#len%2CXmlNode" title="len(n: XmlNode): int">len(n: XmlNode): int</a></li>
    168. 

  168. 

  169. </ul>
    170. 

  170. <ul class="simple nested-toc-section">newCData
    171. 

  171.   <li><a class="reference" href="#newCData%2Csinkstring" title="newCData(cdata: sink string): XmlNode">newCData(cdata: sink string): XmlNode</a></li>
    172. 

  172. 

  173. </ul>
    174. 

  174. <ul class="simple nested-toc-section">newComment
    175. 

  175.   <li><a class="reference" href="#newComment%2Csinkstring" title="newComment(comment: sink string): XmlNode">newComment(comment: sink string): XmlNode</a></li>
    176. 

  176. 

  177. </ul>
    178. 

  178. <ul class="simple nested-toc-section">newElement
    179. 

  179.   <li><a class="reference" href="#newElement%2Csinkstring" title="newElement(tag: sink string): XmlNode">newElement(tag: sink string): XmlNode</a></li>
    180. 

  180. 

  181. </ul>
    182. 

  182. <ul class="simple nested-toc-section">newEntity
    183. 

  183.   <li><a class="reference" href="#newEntity%2Cstring" title="newEntity(entity: string): XmlNode">newEntity(entity: string): XmlNode</a></li>
    184. 

  184. 

  185. </ul>
    186. 

  186. <ul class="simple nested-toc-section">newText
    187. 

  187.   <li><a class="reference" href="#newText%2Csinkstring" title="newText(text: sink string): XmlNode">newText(text: sink string): XmlNode</a></li>
    188. 

  188. 

  189. </ul>
    190. 

  190. <ul class="simple nested-toc-section">newVerbatimText
    191. 

  191.   <li><a class="reference" href="#newVerbatimText%2Csinkstring" title="newVerbatimText(text: sink string): XmlNode">newVerbatimText(text: sink string): XmlNode</a></li>
    192. 

  192. 

  193. </ul>
    194. 

  194. <ul class="simple nested-toc-section">newXmlTree
    195. 

  195.   <li><a class="reference" href="#newXmlTree%2Csinkstring%2CopenArray%5BXmlNode%5D%2CXmlAttributes" title="newXmlTree(tag: sink string; children: openArray[XmlNode];
    196. 

  196.            attributes: XmlAttributes = nil): XmlNode">newXmlTree(tag: sink string; children: openArray[XmlNode];
    197. 

  197.            attributes: XmlAttributes = nil): XmlNode</a></li>
    198. 

  198. 

  199. </ul>
    200. 

  200. <ul class="simple nested-toc-section">rawTag
    201. 

  201.   <li><a class="reference" href="#rawTag%2CXmlNode" title="rawTag(n: XmlNode): string">rawTag(n: XmlNode): string</a></li>
    202. 

  202. 

  203. </ul>
    204. 

  204. <ul class="simple nested-toc-section">rawText
    205. 

  205.   <li><a class="reference" href="#rawText%2CXmlNode" title="rawText(n: XmlNode): string">rawText(n: XmlNode): string</a></li>
    206. 

  206. 

  207. </ul>
    208. 

  208. <ul class="simple nested-toc-section">replace
    209. 

  209.   <li><a class="reference" href="#replace%2CXmlNode%2CNatural%2CopenArray%5BXmlNode%5D" title="replace(n: XmlNode; i: Natural; replacement: openArray[XmlNode])">replace(n: XmlNode; i: Natural; replacement: openArray[XmlNode])</a></li>
    210. 

  210. <li><a class="reference" href="#replace%2CXmlNode%2CSlice%5Bint%5D%2CopenArray%5BXmlNode%5D" title="replace(n: XmlNode; slice: Slice[int]; replacement: openArray[XmlNode])">replace(n: XmlNode; slice: Slice[int]; replacement: openArray[XmlNode])</a></li>
    211. 

  211. 

  212. </ul>
    213. 

  213. <ul class="simple nested-toc-section">tag
    214. 

  214.   <li><a class="reference" href="#tag%2CXmlNode" title="tag(n: XmlNode): lent string">tag(n: XmlNode): lent string</a></li>
    215. 

  215. 

  216. </ul>
    217. 

  217. <ul class="simple nested-toc-section">tag=
    218. 

  218.   <li><a class="reference" href="#tag%3D%2CXmlNode%2Csinkstring" title="tag=(n: XmlNode; tag: sink string)">tag=(n: XmlNode; tag: sink string)</a></li>
    219. 

  219. 

  220. </ul>
    221. 

  221. <ul class="simple nested-toc-section">text
    222. 

  222.   <li><a class="reference" href="#text%2CXmlNode" title="text(n: XmlNode): lent string">text(n: XmlNode): lent string</a></li>
    223. 

  223. 

  224. </ul>
    225. 

  225. <ul class="simple nested-toc-section">text=
    226. 

  226.   <li><a class="reference" href="#text%3D%2CXmlNode%2Csinkstring" title="text=(n: XmlNode; text: sink string)">text=(n: XmlNode; text: sink string)</a></li>
    227. 

  227. 

  228. </ul>
    229. 

  229. <ul class="simple nested-toc-section">toXmlAttributes
    230. 

  230.   <li><a class="reference" href="#toXmlAttributes%2Cvarargs%5Btuple%5Bstring%2Cstring%5D%5D" title="toXmlAttributes(keyValuePairs: varargs[tuple[key, val: string]]): XmlAttributes">toXmlAttributes(keyValuePairs: varargs[tuple[key, val: string]]): XmlAttributes</a></li>
    231. 

  231. 

  232. </ul>
    233. 

  233. 

  234.     </ul>
    235. 

  235.   </details>
    236. 

  236. </li>
    237. 

  237. <li>
    238. 

  238.   <details open>
    239. 

  239.     <summary><a class="reference reference-toplevel" href="#15" id="65">Iterators</a></summary>
    240. 

  240.     <ul class="simple simple-toc-section">
    241. 

  241.       <ul class="simple nested-toc-section">items
    242. 

  242.   <li><a class="reference" href="#items.i%2CXmlNode" title="items(n: XmlNode): XmlNode">items(n: XmlNode): XmlNode</a></li>
    243. 

  243. 

  244. </ul>
    245. 

  245. <ul class="simple nested-toc-section">mitems
    246. 

  246.   <li><a class="reference" href="#mitems.i%2CXmlNode" title="mitems(n: var XmlNode): var XmlNode">mitems(n: var XmlNode): var XmlNode</a></li>
    247. 

  247. 

  248. </ul>
    249. 

  249. 

  250.     </ul>
    251. 

  251.   </details>
    252. 

  252. </li>
    253. 

  253. <li>
    254. 

  254.   <details open>
    255. 

  255.     <summary><a class="reference reference-toplevel" href="#17" id="67">Macros</a></summary>
    256. 

  256.     <ul class="simple simple-toc-section">
    257. 

  257.       <ul class="simple nested-toc-section"><>
    258. 

  258.   <li><a class="reference" href="#%3C%3E.m%2Cuntyped" title="`&lt;&gt;`(x: untyped): untyped">`&lt;&gt;`(x: untyped): untyped</a></li>
    259. 

  259. 

  260. </ul>
    261. 

  261. 

  262.     </ul>
    263. 

  263.   </details>
    264. 

  264. </li>
    265. 

  265. 

  266. </ul>
    267. 

  267. 

  268.   </div>
    269. 

  269.   <div class="nine columns" id="content">
    270. 

  270.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L1" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    271. 

  271. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L1" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    272. 

  272. 

  273.     <div id="tocRoot"></div>
    274. 

  274.     
    275. 

  275.     <p class="module-desc">A simple XML tree generator. 
    276. 

  276. <p><strong class="examples_text">Example:</strong></p>
    277. 

  277. <pre class="listing"><span class="Keyword">import</span> <span class="Identifier">std</span><span class="Operator">/</span><span class="Identifier">xmltree</span>
    278. 

  278. <span class="Keyword">var</span> <span class="Identifier">g</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    279. 

  279. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;some text&quot;</span><span class="Punctuation">)</span>
    280. 

  280. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;this is comment&quot;</span><span class="Punctuation">)</span>
    281. 

  281. 

  282. <span class="Keyword">var</span> <span class="Identifier">h</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;secondTag&quot;</span><span class="Punctuation">)</span>
    283. 

  283. <span class="Identifier">h</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;some entity&quot;</span><span class="Punctuation">)</span>
    284. 

  284. 

  285. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    286. 

  286. <span class="Keyword">let</span> <span class="Identifier">k</span> <span class="Operator">=</span> <span class="Identifier">newXmlTree</span><span class="Punctuation">(</span><span class="StringLit">&quot;treeTag&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Identifier">g</span><span class="Punctuation">,</span> <span class="Identifier">h</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="Identifier">att</span><span class="Punctuation">)</span>
    287. 

  287. 

  288. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">k</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;treeTag key1=&quot;first value&quot; key2=&quot;second value&quot;&gt;
    289. 

  289.   &lt;myTag&gt;some text&lt;!-- this is comment --&gt;&lt;/myTag&gt;
    290. 

  290.   &lt;secondTag&gt;&amp;some entity;&lt;/secondTag&gt;
    291. 

  291. &lt;/treeTag&gt;&quot;&quot;&quot;</span></pre><strong>See also:</strong><ul class="simple"><li><a class="reference external" href="xmlparser.html">xmlparser module</a> for high-level XML parsing</li>
    292. 

  292. <li><a class="reference external" href="parsexml.html">parsexml module</a> for low-level XML parsing</li>
    293. 

  293. <li><a class="reference external" href="htmlgen.html">htmlgen module</a> for html code generator</li>
    294. 

  294. </ul>
    295. 

  295. </p>
    296. 

  296.     <div class="section" id="6">
    297. 

  297.   <h1><a class="toc-backref" href="#6">Imports</a></h1>
    298. 

  298.   <dl class="item">
    299. 

  299.     <a class="reference external" href="since.html">since</a>, <a class="reference external" href="macros.html">macros</a>, <a class="reference external" href="strtabs.html">strtabs</a>, <a class="reference external" href="strutils.html">strutils</a>, <a class="reference external" href="sequtils.html">sequtils</a>, <a class="reference external" href="assertions.html">assertions</a>
    300. 

  300.   </dl>
    301. 

  301. </div>
    302. 

  302. <div class="section" id="7">
    303. 

  303.   <h1><a class="toc-backref" href="#7">Types</a></h1>
    304. 

  304.   <dl class="item">
    305. 

  305.     <div id="XmlAttributes">
    306. 

  306.   <dt><pre><a href="xmltree.html#XmlAttributes"><span class="Identifier">XmlAttributes</span></a> <span class="Other">=</span> <a href="strtabs.html#StringTableRef"><span class="Identifier">StringTableRef</span></a></pre></dt>
    307. 

  307.   <dd>
    308. 

  308.     
    309. 

  309.     <p>An alias for a string to string mapping.</p>
    310. 

  310. <p>Use <a class="reference external" href="#toXmlAttributes,varargs[tuple[string,string]]">toXmlAttributes proc</a> to create <tt class="docutils literal"><span class="pre"><span class="Identifier">XmlAttributes</span></span></tt>.</p>
    311. 

  311. 

  312.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L54" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    313. 

  313. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L54" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    314. 

  314. 

  315.   </dd>
    316. 

  316. </div>
    317. 

  317. <div id="XmlNode">
    318. 

  318.   <dt><pre><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> <span class="Other">=</span> <span class="Keyword">ref</span> <span class="Identifier">XmlNodeObj</span></pre></dt>
    319. 

  319.   <dd>
    320. 

  320.     
    321. 

  321.     <p>An XML tree consisting of XML nodes.</p>
    322. 

  322. <p>Use <a class="reference external" href="#newXmlTree,string,openArray[XmlNode],XmlAttributes">newXmlTree proc</a> for creating a new tree.</p>
    323. 

  323. 

  324.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L41" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    325. 

  325. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L41" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    326. 

  326. 

  327.   </dd>
    328. 

  328. </div>
    329. 

  329. <div id="XmlNodeKind">
    330. 

  330.   <dt><pre><a href="xmltree.html#XmlNodeKind"><span class="Identifier">XmlNodeKind</span></a> <span class="Other">=</span> <span class="Keyword">enum</span>
    331. 

  331.   <span class="Identifier">xnText</span><span class="Other">,</span>                   <span class="Comment">## a text element</span>
    332. 

  332.   <span class="Identifier">xnVerbatimText</span><span class="Other">,</span> <span class="Identifier">xnElement</span><span class="Other">,</span> <span class="Comment">## an element with 0 or more children</span>
    333. 

  333.   <span class="Identifier">xnCData</span><span class="Other">,</span>                  <span class="Comment">## a CDATA node</span>
    334. 

  334.   <span class="Identifier">xnEntity</span><span class="Other">,</span>                 <span class="Comment">## an entity (like ``&amp;thing;``)</span>
    335. 

  335.   <span class="Identifier">xnComment</span>                  <span class="Comment">## an XML comment</span></pre></dt>
    336. 

  336.   <dd>
    337. 

  337.     
    338. 

  338.     Different kinds of XML nodes.
    339. 

  339.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L46" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    340. 

  340. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L46" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    341. 

  341. 

  342.   </dd>
    343. 

  343. </div>
    344. 

  344. 

  345.   </dl>
    346. 

  346. </div>
    347. 

  347. <div class="section" id="10">
    348. 

  348.   <h1><a class="toc-backref" href="#10">Consts</a></h1>
    349. 

  349.   <dl class="item">
    350. 

  350.     <div id="xmlHeader">
    351. 

  351.   <dt><pre><a href="xmltree.html#xmlHeader"><span class="Identifier">xmlHeader</span></a> <span class="Other">=</span> <span class="StringLit">&quot;&lt;?xml version=\&quot;1.0\&quot; encoding=\&quot;UTF-8\&quot; ?&gt;\n&quot;</span></pre></dt>
    352. 

  352.   <dd>
    353. 

  353.     
    354. 

  354.     Header to use for complete XML output.
    355. 

  355.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L70" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    356. 

  356. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L70" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    357. 

  357. 

  358.   </dd>
    359. 

  359. </div>
    360. 

  360. 

  361.   </dl>
    362. 

  362. </div>
    363. 

  363. <div class="section" id="12">
    364. 

  364.   <h1><a class="toc-backref" href="#12">Procs</a></h1>
    365. 

  365.   <dl class="item">
    366. 

  366.     <div id="$-procs-all">
    367. 

  367.   <div id="$,XmlNode">
    368. 

  368.   <dt><pre><span class="Keyword">proc</span> <a href="#%24%2CXmlNode"><span class="Identifier">`$`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    369. 

  369.   <dd>
    370. 

  370.     
    371. 

  371.     <p>Converts <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> into its string representation.</p>
    372. 

  372. <p>No <tt class="docutils literal"><span class="pre">&lt;$xml ...$&gt;</span></tt> declaration is produced, so that the produced XML fragments are composable.</p>
    373. 

  373. 

  374.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L830" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    375. 

  375. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L830" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    376. 

  376. 

  377.   </dd>
    378. 

  378. </div>
    379. 

  379. 

  380. </div>
    381. 

  381. <div id="[]-procs-all">
    382. 

  382.   <div id="[],XmlNode,int_2">
    383. 

  383.   <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%2CXmlNode%2Cint_2"><span class="Identifier">`[]`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    384. 

  384.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    385. 

  385.   <dd>
    386. 

  386.     
    387. 

  387.     Returns the <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> so that it can be modified.
    388. 

  388.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L540" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    389. 

  389. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L540" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    390. 

  390. 

  391.   </dd>
    392. 

  392. </div>
    393. 

  393. <div id="[],XmlNode,int">
    394. 

  394.   <dt><pre><span class="Keyword">proc</span> <a href="#%5B%5D%2CXmlNode%2Cint"><span class="Identifier">`[]`</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    395. 

  395.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    396. 

  396.   <dd>
    397. 

  397.     
    398. 

  398.     Returns the <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.
    399. 

  399. <p><strong class="examples_text">Example:</strong></p>
    400. 

  400. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    401. 

  401. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    402. 

  402. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    403. 

  403. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span><span class="Punctuation">[</span><span class="DecNumber">1</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;first /&gt;&quot;</span>
    404. 

  404. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span><span class="Punctuation">[</span><span class="DecNumber">0</span><span class="Punctuation">]</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;second /&gt;&quot;</span></pre>
    405. 

  405.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L528" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    406. 

  406. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L528" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    407. 

  407. 

  408.   </dd>
    409. 

  409. </div>
    410. 

  410. 

  411. </div>
    412. 

  412. <div id="add-procs-all">
    413. 

  413.   <div id="add,XmlNode,XmlNode">
    414. 

  414.   <dt><pre><span class="Keyword">proc</span> <a href="#add%2CXmlNode%2CXmlNode"><span class="Identifier">add</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">,</span> <span class="Identifier">son</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    415. 

  415.   <dd>
    416. 

  416.     
    417. 

  417.     <p>Adds the child <tt class="docutils literal"><span class="pre"><span class="Identifier">son</span></span></tt> to <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt>. <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> must be of <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt> type</p>
    418. 

  418. <p>See also:</p>
    419. 

  419. <ul class="simple"><li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    420. 

  420. <li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    421. 

  421. <li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    422. 

  422. <li><a class="reference external" href="#delete,XmlNode,Natural">delete proc</a></li>
    423. 

  423. <li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    424. 

  424. <li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    425. 

  425. <li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    426. 

  426. </ul>
    427. 

  427. 

  428. <p><strong class="examples_text">Example:</strong></p>
    429. 

  429. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    430. 

  430. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;my text&quot;</span><span class="Punctuation">)</span>
    431. 

  431. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;sonTag&quot;</span><span class="Punctuation">)</span>
    432. 

  432. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;my entity&quot;</span><span class="Punctuation">)</span>
    433. 

  433. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;myTag&gt;my text&lt;sonTag /&gt;&amp;my entity;&lt;/myTag&gt;&quot;</span></pre>
    434. 

  434.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L307" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    435. 

  435. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L307" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    436. 

  436. 

  437.   </dd>
    438. 

  438. </div>
    439. 

  439. <div id="add,XmlNode,openArray[XmlNode]">
    440. 

  440.   <dt><pre><span class="Keyword">proc</span> <a href="#add%2CXmlNode%2CopenArray%5BXmlNode%5D"><span class="Identifier">add</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">sons</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    441. 

  441.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    442. 

  442.   <dd>
    443. 

  443.     
    444. 

  444.     <p>Adds the children <tt class="docutils literal"><span class="pre"><span class="Identifier">sons</span></span></tt> to <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt>. <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> must be of <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt> type</p>
    445. 

  445. <p>See also:</p>
    446. 

  446. <ul class="simple"><li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    447. 

  447. <li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    448. 

  448. <li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    449. 

  449. <li><a class="reference external" href="#delete,XmlNode,Natural">delete proc</a></li>
    450. 

  450. <li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    451. 

  451. <li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    452. 

  452. <li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    453. 

  453. </ul>
    454. 

  454. 

  455. <p><strong class="examples_text">Example:</strong></p>
    456. 

  456. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    457. 

  457. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Operator">@</span><span class="Punctuation">[</span><span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;my text&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;sonTag&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;my entity&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">)</span>
    458. 

  458. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;myTag&gt;my text&lt;sonTag /&gt;&amp;my entity;&lt;/myTag&gt;&quot;</span></pre>
    459. 

  459.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L329" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    460. 

  460. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L329" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    461. 

  461. 

  462.   </dd>
    463. 

  463. </div>
    464. 

  464. <div id="add,string,XmlNode,int,int">
    465. 

  465.   <dt><pre><span class="Keyword">proc</span> <a href="#add%2Cstring%2CXmlNode%2Cint%2Cint"><span class="Identifier">add</span></a><span class="Other">(</span><span class="Identifier">result</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">indent</span> <span class="Other">=</span> <span class="DecNumber">0</span><span class="Other">;</span> <span class="Identifier">indWidth</span> <span class="Other">=</span> <span class="DecNumber">2</span><span class="Other">;</span>
    466. 

  466.          <span class="Identifier">addNewLines</span> <span class="Other">=</span> <span class="Identifier">true</span><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    467. 

  467.   <dd>
    468. 

  468.     
    469. 

  469.     Adds the textual representation of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> to string <tt class="docutils literal"><span class="pre"><span class="Identifier">result</span></span></tt>.
    470. 

  470. <p><strong class="examples_text">Example:</strong></p>
    471. 

  471. <pre class="listing"><span class="Keyword">var</span>
    472. 

  472.   <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;firstTag&quot;</span><span class="Punctuation">)</span>
    473. 

  473.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;my text&quot;</span><span class="Punctuation">)</span>
    474. 

  474.   <span class="Identifier">c</span> <span class="Operator">=</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;my comment&quot;</span><span class="Punctuation">)</span>
    475. 

  475.   <span class="Identifier">s</span> <span class="Operator">=</span> <span class="StringLit">&quot;&quot;</span>
    476. 

  476. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">c</span><span class="Punctuation">)</span>
    477. 

  477. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Punctuation">)</span>
    478. 

  478. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">add</span><span class="Punctuation">(</span><span class="Identifier">b</span><span class="Punctuation">)</span>
    479. 

  479. <span class="Identifier">assert</span> <span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;!-- my comment --&gt;&lt;firstTag /&gt;my text&quot;</span></pre>
    480. 

  480.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L815" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    481. 

  481. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L815" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    482. 

  482. 

  483.   </dd>
    484. 

  484. </div>
    485. 

  485. 

  486. </div>
    487. 

  487. <div id="addEscaped-procs-all">
    488. 

  488.   <div id="addEscaped,string,string">
    489. 

  489.   <dt><pre><span class="Keyword">proc</span> <a href="#addEscaped%2Cstring%2Cstring"><span class="Identifier">addEscaped</span></a><span class="Other">(</span><span class="Identifier">result</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    490. 

  490.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    491. 

  491.   <dd>
    492. 

  492.     
    493. 

  493.     The same as <a class="reference external" href="#escape,string">result.add(escape(s))</a>, but more efficient.
    494. 

  494.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L700" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    495. 

  495. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L700" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    496. 

  496. 

  497.   </dd>
    498. 

  498. </div>
    499. 

  499. 

  500. </div>
    501. 

  501. <div id="attr-procs-all">
    502. 

  502.   <div id="attr,XmlNode,string">
    503. 

  503.   <dt><pre><span class="Keyword">proc</span> <a href="#attr%2CXmlNode%2Cstring"><span class="Identifier">attr</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    504. 

  504.   <dd>
    505. 

  505.     
    506. 

  506.     <p>Finds the first attribute of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> with a name of <tt class="docutils literal"><span class="pre"><span class="Identifier">name</span></span></tt>. Returns &quot;&quot; on failure.</p>
    507. 

  507. <p>See also:</p>
    508. 

  508. <ul class="simple"><li><a class="reference external" href="#attrs,XmlNode">attrs proc</a> for XmlAttributes getter</li>
    509. 

  509. <li><a class="reference external" href="#attrs=,XmlNode,XmlAttributes">attrs= proc</a> for XmlAttributes setter</li>
    510. 

  510. <li><a class="reference external" href="#attrsLen,XmlNode">attrsLen proc</a> for number of attributes</li>
    511. 

  511. </ul>
    512. 

  512. 

  513. <p><strong class="examples_text">Example:</strong></p>
    514. 

  514. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">j</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    515. 

  515. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    516. 

  516. <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">=</span> <span class="Identifier">att</span>
    517. 

  517. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attr</span><span class="Punctuation">(</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;first value&quot;</span>
    518. 

  518. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attr</span><span class="Punctuation">(</span><span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;second value&quot;</span></pre>
    519. 

  519.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L669" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    520. 

  520. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L669" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    521. 

  521. 

  522.   </dd>
    523. 

  523. </div>
    524. 

  524. 

  525. </div>
    526. 

  526. <div id="attrs-procs-all">
    527. 

  527.   <div id="attrs,XmlNode">
    528. 

  528.   <dt><pre><span class="Keyword">proc</span> <a href="#attrs%2CXmlNode"><span class="Identifier">attrs</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlAttributes"><span class="Identifier">XmlAttributes</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    529. 

  529.                                         <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    530. 

  530.   <dd>
    531. 

  531.     
    532. 

  532.     <p>Gets the attributes belonging to <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    533. 

  533. <p>Returns <tt class="docutils literal"><span class="pre"><span class="Keyword">nil</span></span></tt> if attributes have not been initialised for this node.</p>
    534. 

  534. <p>See also:</p>
    535. 

  535. <ul class="simple"><li><a class="reference external" href="#attrs=,XmlNode,XmlAttributes">attrs= proc</a> for XmlAttributes setter</li>
    536. 

  536. <li><a class="reference external" href="#attrsLen,XmlNode">attrsLen proc</a> for number of attributes</li>
    537. 

  537. <li><a class="reference external" href="#attr,XmlNode,string">attr proc</a> for finding an attribute</li>
    538. 

  538. </ul>
    539. 

  539. 

  540. <p><strong class="examples_text">Example:</strong></p>
    541. 

  541. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">j</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    542. 

  542. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">==</span> <span class="Keyword">nil</span>
    543. 

  543. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    544. 

  544. <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">=</span> <span class="Identifier">att</span>
    545. 

  545. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">==</span> <span class="Identifier">att</span></pre>
    546. 

  546.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L615" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    547. 

  547. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L615" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    548. 

  548. 

  549.   </dd>
    550. 

  550. </div>
    551. 

  551. 

  552. </div>
    553. 

  553. <div id="attrs=-procs-all">
    554. 

  554.   <div id="attrs=,XmlNode,XmlAttributes">
    555. 

  555.   <dt><pre><span class="Keyword">proc</span> <a href="#attrs%3D%2CXmlNode%2CXmlAttributes"><span class="Identifier">attrs=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">attr</span><span class="Other">:</span> <a href="xmltree.html#XmlAttributes"><span class="Identifier">XmlAttributes</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    556. 

  556.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    557. 

  557.   <dd>
    558. 

  558.     
    559. 

  559.     <p>Sets the attributes belonging to <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    560. 

  560. <p>See also:</p>
    561. 

  561. <ul class="simple"><li><a class="reference external" href="#attrs,XmlNode">attrs proc</a> for XmlAttributes getter</li>
    562. 

  562. <li><a class="reference external" href="#attrsLen,XmlNode">attrsLen proc</a> for number of attributes</li>
    563. 

  563. <li><a class="reference external" href="#attr,XmlNode,string">attr proc</a> for finding an attribute</li>
    564. 

  564. </ul>
    565. 

  565. 

  566. <p><strong class="examples_text">Example:</strong></p>
    567. 

  567. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">j</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    568. 

  568. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">==</span> <span class="Keyword">nil</span>
    569. 

  569. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    570. 

  570. <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">=</span> <span class="Identifier">att</span>
    571. 

  571. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">==</span> <span class="Identifier">att</span></pre>
    572. 

  572.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L634" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    573. 

  573. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L634" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    574. 

  574. 

  575.   </dd>
    576. 

  576. </div>
    577. 

  577. 

  578. </div>
    579. 

  579. <div id="attrsLen-procs-all">
    580. 

  580.   <div id="attrsLen,XmlNode">
    581. 

  581.   <dt><pre><span class="Keyword">proc</span> <a href="#attrsLen%2CXmlNode"><span class="Identifier">attrsLen</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    582. 

  582.   <dd>
    583. 

  583.     
    584. 

  584.     <p>Returns the number of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s attributes.</p>
    585. 

  585. <p>See also:</p>
    586. 

  586. <ul class="simple"><li><a class="reference external" href="#attrs,XmlNode">attrs proc</a> for XmlAttributes getter</li>
    587. 

  587. <li><a class="reference external" href="#attrs=,XmlNode,XmlAttributes">attrs= proc</a> for XmlAttributes setter</li>
    588. 

  588. <li><a class="reference external" href="#attr,XmlNode,string">attr proc</a> for finding an attribute</li>
    589. 

  589. </ul>
    590. 

  590. 

  591. <p><strong class="examples_text">Example:</strong></p>
    592. 

  592. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">j</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    593. 

  593. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrsLen</span> <span class="Operator">==</span> <span class="DecNumber">0</span>
    594. 

  594. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    595. 

  595. <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">=</span> <span class="Identifier">att</span>
    596. 

  596. <span class="Identifier">assert</span> <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrsLen</span> <span class="Operator">==</span> <span class="DecNumber">2</span></pre>
    597. 

  597.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L651" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    598. 

  598. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L651" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    599. 

  599. 

  600.   </dd>
    601. 

  601. </div>
    602. 

  602. 

  603. </div>
    604. 

  604. <div id="child-procs-all">
    605. 

  605.   <div id="child,XmlNode,string">
    606. 

  606.   <dt><pre><span class="Keyword">proc</span> <a href="#child%2CXmlNode%2Cstring"><span class="Identifier">child</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">name</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    607. 

  607.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    608. 

  608.   <dd>
    609. 

  609.     
    610. 

  610.     Finds the first child element of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> with a name of <tt class="docutils literal"><span class="pre"><span class="Identifier">name</span></span></tt>. Returns <tt class="docutils literal"><span class="pre"><span class="Keyword">nil</span></span></tt> on failure.
    611. 

  611. <p><strong class="examples_text">Example:</strong></p>
    612. 

  612. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    613. 

  613. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;firstSon&quot;</span><span class="Punctuation">)</span>
    614. 

  614. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;secondSon&quot;</span><span class="Punctuation">)</span>
    615. 

  615. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;thirdSon&quot;</span><span class="Punctuation">)</span>
    616. 

  616. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">child</span><span class="Punctuation">(</span><span class="StringLit">&quot;secondSon&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;secondSon /&gt;&quot;</span></pre>
    617. 

  617.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L838" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    618. 

  618. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L838" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    619. 

  619. 

  620.   </dd>
    621. 

  621. </div>
    622. 

  622. 

  623. </div>
    624. 

  624. <div id="clear-procs-all">
    625. 

  625.   <div id="clear,XmlNode">
    626. 

  626.   <dt><pre><span class="Keyword">proc</span> <a href="#clear%2CXmlNode"><span class="Identifier">clear</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    627. 

  627.   <dd>
    628. 

  628.     
    629. 

  629.     Recursively clears all children of an XmlNode. 
    630. 

  630. <p><strong class="examples_text">Example:</strong></p>
    631. 

  631. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">g</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    632. 

  632. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;some text&quot;</span><span class="Punctuation">)</span>
    633. 

  633. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;this is comment&quot;</span><span class="Punctuation">)</span>
    634. 

  634. 

  635. <span class="Keyword">var</span> <span class="Identifier">h</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;secondTag&quot;</span><span class="Punctuation">)</span>
    636. 

  636. <span class="Identifier">h</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;some entity&quot;</span><span class="Punctuation">)</span>
    637. 

  637. 

  638. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    639. 

  639. <span class="Keyword">var</span> <span class="Identifier">k</span> <span class="Operator">=</span> <span class="Identifier">newXmlTree</span><span class="Punctuation">(</span><span class="StringLit">&quot;treeTag&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Identifier">g</span><span class="Punctuation">,</span> <span class="Identifier">h</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="Identifier">att</span><span class="Punctuation">)</span>
    640. 

  640. 

  641. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">k</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;treeTag key1=&quot;first value&quot; key2=&quot;second value&quot;&gt;
    642. 

  642.   &lt;myTag&gt;some text&lt;!-- this is comment --&gt;&lt;/myTag&gt;
    643. 

  643.   &lt;secondTag&gt;&amp;some entity;&lt;/secondTag&gt;
    644. 

  644. &lt;/treeTag&gt;&quot;&quot;&quot;</span>
    645. 

  645. 

  646. <span class="Identifier">clear</span><span class="Punctuation">(</span><span class="Identifier">k</span><span class="Punctuation">)</span>
    647. 

  647. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">k</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;treeTag key1=&quot;first value&quot; key2=&quot;second value&quot; /&gt;&quot;&quot;&quot;</span></pre>
    648. 

  648.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L545" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    649. 

  649. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L545" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    650. 

  650. 

  651.   </dd>
    652. 

  652. </div>
    653. 

  653. 

  654. </div>
    655. 

  655. <div id="clientData-procs-all">
    656. 

  656.   <div id="clientData,XmlNode">
    657. 

  657.   <dt><pre><span class="Keyword">proc</span> <a href="#clientData%2CXmlNode"><span class="Identifier">clientData</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    658. 

  658.   <dd>
    659. 

  659.     
    660. 

  660.     <p>Gets the client data of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    661. 

  661. <p>The client data field is used by the HTML parser and generator.</p>
    662. 

  662. 

  663.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L688" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    664. 

  664. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L688" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    665. 

  665. 

  666.   </dd>
    667. 

  667. </div>
    668. 

  668. 

  669. </div>
    670. 

  670. <div id="clientData=-procs-all">
    671. 

  671.   <div id="clientData=,XmlNode,int">
    672. 

  672.   <dt><pre><span class="Keyword">proc</span> <a href="#clientData%3D%2CXmlNode%2Cint"><span class="Identifier">clientData=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">data</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    673. 

  673.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    674. 

  674.   <dd>
    675. 

  675.     
    676. 

  676.     <p>Sets the client data of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    677. 

  677. <p>The client data field is used by the HTML parser and generator.</p>
    678. 

  678. 

  679.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L694" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    680. 

  680. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L694" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    681. 

  681. 

  682.   </dd>
    683. 

  683. </div>
    684. 

  684. 

  685. </div>
    686. 

  686. <div id="delete-procs-all">
    687. 

  687.   <div id="delete,XmlNode,Natural">
    688. 

  688.   <dt><pre><span class="Keyword">proc</span> <a href="#delete%2CXmlNode%2CNatural"><span class="Identifier">delete</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    689. 

  689.   <dd>
    690. 

  690.     
    691. 

  691.     <p>Deletes the <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    692. 

  692. <p>See also:</p>
    693. 

  693. <ul class="simple"><li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    694. 

  694. <li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    695. 

  695. <li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    696. 

  696. <li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    697. 

  697. <li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    698. 

  698. <li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    699. 

  699. <li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    700. 

  700. </ul>
    701. 

  701. 

  702. <p><strong class="examples_text">Example:</strong></p>
    703. 

  703. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    704. 

  704. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    705. 

  705. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    706. 

  706. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span>
    707. 

  707. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag&gt;
    708. 

  708.   &lt;first /&gt;
    709. 

  709. &lt;/myTag&gt;&quot;&quot;&quot;</span></pre>
    710. 

  710.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L407" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    711. 

  711. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L407" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    712. 

  712. 

  713.   </dd>
    714. 

  714. </div>
    715. 

  715. <div id="delete,XmlNode,Slice[int]">
    716. 

  716.   <dt><pre><span class="Keyword">proc</span> <a href="#delete%2CXmlNode%2CSlice%5Bint%5D"><span class="Identifier">delete</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">slice</span><span class="Other">:</span> <a href="system.html#Slice"><span class="Identifier">Slice</span></a><span class="Other">[</span><a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">]</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    717. 

  717.   <dd>
    718. 

  718.     
    719. 

  719.     <p>Deletes the items <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span><span class="Punctuation">[</span><span class="Identifier">slice</span><span class="Punctuation">]</span></span></tt> of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    720. 

  720. <p>See also:</p>
    721. 

  721. <ul class="simple"><li><a class="reference external" href="#delete.XmlNode,int">delete proc</a></li>
    722. 

  722. <li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    723. 

  723. <li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    724. 

  724. <li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    725. 

  725. <li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    726. 

  726. <li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    727. 

  727. <li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    728. 

  728. </ul>
    729. 

  729. 

  730. <p><strong class="examples_text">Example:</strong></p>
    731. 

  731. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    732. 

  732. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    733. 

  733. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Punctuation">[</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;third&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    734. 

  734. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">delete</span><span class="Punctuation">(</span><span class="FloatNumber">0.</span><span class="Operator">.</span><span class="DecNumber">1</span><span class="Punctuation">)</span>
    735. 

  735. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag&gt;
    736. 

  736.   &lt;first /&gt;
    737. 

  737. &lt;/myTag&gt;&quot;&quot;&quot;</span></pre>
    738. 

  738.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L430" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    739. 

  739. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L430" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    740. 

  740. 

  741.   </dd>
    742. 

  742. </div>
    743. 

  743. 

  744. </div>
    745. 

  745. <div id="escape-procs-all">
    746. 

  746.   <div id="escape,string">
    747. 

  747.   <dt><pre><span class="Keyword">proc</span> <a href="#escape%2Cstring"><span class="Identifier">escape</span></a><span class="Other">(</span><span class="Identifier">s</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    748. 

  748.   <dd>
    749. 

  749.     
    750. 

  750.     <p>Escapes <tt class="docutils literal"><span class="pre"><span class="Identifier">s</span></span></tt> for inclusion into an XML document.</p>
    751. 

  751. <p>Escapes these characters:</p>
    752. 

  752. <table border="1" class="docutils"><tr><th>char</th><th>is converted to</th></tr>
    753. 

  753. <tr><td><tt class="docutils literal"><span class="pre">&lt;</span></tt></td><td><tt class="docutils literal"><span class="pre">&amp;lt;</span></tt></td></tr>
    754. 

  754. <tr><td><tt class="docutils literal"><span class="pre">&gt;</span></tt></td><td><tt class="docutils literal"><span class="pre">&amp;gt;</span></tt></td></tr>
    755. 

  755. <tr><td><tt class="docutils literal"><span class="pre">&amp;</span></tt></td><td><tt class="docutils literal"><span class="pre">&amp;amp;</span></tt></td></tr>
    756. 

  756. <tr><td><tt class="docutils literal"><span class="pre">&quot;</span></tt></td><td><tt class="docutils literal"><span class="pre">&amp;quot;</span></tt></td></tr>
    757. 

  757. <tr><td><tt class="docutils literal"><span class="pre">'</span></tt></td><td><tt class="docutils literal"><span class="pre">&amp;apos;</span></tt></td></tr>
    758. 

  758. </table><p>You can also use <a class="reference external" href="#addEscaped,string,string">addEscaped proc</a>.</p>
    759. 

  759. 

  760.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L711" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    761. 

  761. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L711" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    762. 

  762. 

  763.   </dd>
    764. 

  764. </div>
    765. 

  765. 

  766. </div>
    767. 

  767. <div id="findAll-procs-all">
    768. 

  768.   <div id="findAll,XmlNode,string">
    769. 

  769.   <dt><pre><span class="Keyword">proc</span> <a href="#findAll%2CXmlNode%2Cstring"><span class="Identifier">findAll</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">tag</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">caseInsensitive</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span><span class="Other">:</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span> {.
    770. 

  770.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    771. 

  771.   <dd>
    772. 

  772.     
    773. 

  773.     A shortcut version to assign in let blocks.
    774. 

  774. <p><strong class="examples_text">Example:</strong></p>
    775. 

  775. <pre class="listing"><span class="Keyword">var</span>
    776. 

  776.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;good&quot;</span><span class="Punctuation">)</span>
    777. 

  777.   <span class="Identifier">c</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;bad&quot;</span><span class="Punctuation">)</span>
    778. 

  778.   <span class="Identifier">d</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;BAD&quot;</span><span class="Punctuation">)</span>
    779. 

  779.   <span class="Identifier">e</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;GOOD&quot;</span><span class="Punctuation">)</span>
    780. 

  780. <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;b text&quot;</span><span class="Punctuation">)</span>
    781. 

  781. <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;c text&quot;</span><span class="Punctuation">)</span>
    782. 

  782. <span class="Identifier">d</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;d text&quot;</span><span class="Punctuation">)</span>
    783. 

  783. <span class="Identifier">e</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;e text&quot;</span><span class="Punctuation">)</span>
    784. 

  784. <span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newXmlTree</span><span class="Punctuation">(</span><span class="StringLit">&quot;father&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Identifier">b</span><span class="Punctuation">,</span> <span class="Identifier">c</span><span class="Punctuation">,</span> <span class="Identifier">d</span><span class="Punctuation">,</span> <span class="Identifier">e</span><span class="Punctuation">]</span><span class="Punctuation">)</span>
    785. 

  785. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;good&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;good&gt;b text&lt;/good&gt;]&quot;</span>
    786. 

  786. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;BAD&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;BAD&gt;d text&lt;/BAD&gt;]&quot;</span>
    787. 

  787. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;good&quot;</span><span class="Punctuation">,</span> <span class="Identifier">caseInsensitive</span> <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;good&gt;b text&lt;/good&gt;, &lt;GOOD&gt;e text&lt;/GOOD&gt;]&quot;</span>
    788. 

  788. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Punctuation">(</span><span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;BAD&quot;</span><span class="Punctuation">,</span> <span class="Identifier">caseInsensitive</span> <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">)</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;bad&gt;c text&lt;/bad&gt;, &lt;BAD&gt;d text&lt;/BAD&gt;]&quot;</span></pre>
    789. 

  789.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L893" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    790. 

  790. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L893" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    791. 

  791. 

  792.   </dd>
    793. 

  793. </div>
    794. 

  794. <div id="findAll,XmlNode,string,seq[XmlNode]">
    795. 

  795.   <dt><pre><span class="Keyword">proc</span> <a href="#findAll%2CXmlNode%2Cstring%2Cseq%5BXmlNode%5D"><span class="Identifier">findAll</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">tag</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">result</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="system.html#seq"><span class="Identifier">seq</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span><span class="Other">;</span>
    796. 

  796.              <span class="Identifier">caseInsensitive</span> <span class="Other">=</span> <span class="Identifier">false</span><span class="Other">)</span> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    797. 

  797.   <dd>
    798. 

  798.     
    799. 

  799.     <p>Iterates over all the children of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> returning those matching <tt class="docutils literal"><span class="pre"><span class="Identifier">tag</span></span></tt>.</p>
    800. 

  800. <p>Found nodes satisfying the condition will be appended to the <tt class="docutils literal"><span class="pre"><span class="Identifier">result</span></span></tt> sequence.</p>
    801. 

  801. 

  802. <p><strong class="examples_text">Example:</strong></p>
    803. 

  803. <pre class="listing"><span class="Keyword">var</span>
    804. 

  804.   <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;good&quot;</span><span class="Punctuation">)</span>
    805. 

  805.   <span class="Identifier">c</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;bad&quot;</span><span class="Punctuation">)</span>
    806. 

  806.   <span class="Identifier">d</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;BAD&quot;</span><span class="Punctuation">)</span>
    807. 

  807.   <span class="Identifier">e</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;GOOD&quot;</span><span class="Punctuation">)</span>
    808. 

  808. <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;b text&quot;</span><span class="Punctuation">)</span>
    809. 

  809. <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;c text&quot;</span><span class="Punctuation">)</span>
    810. 

  810. <span class="Identifier">d</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;d text&quot;</span><span class="Punctuation">)</span>
    811. 

  811. <span class="Identifier">e</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;e text&quot;</span><span class="Punctuation">)</span>
    812. 

  812. <span class="Keyword">let</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newXmlTree</span><span class="Punctuation">(</span><span class="StringLit">&quot;father&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Identifier">b</span><span class="Punctuation">,</span> <span class="Identifier">c</span><span class="Punctuation">,</span> <span class="Identifier">d</span><span class="Punctuation">,</span> <span class="Identifier">e</span><span class="Punctuation">]</span><span class="Punctuation">)</span>
    813. 

  813. <span class="Keyword">var</span> <span class="Identifier">s</span> <span class="Operator">=</span> <span class="Identifier">newSeq</span><span class="Punctuation">[</span><span class="Identifier">XmlNode</span><span class="Punctuation">]</span><span class="Punctuation">(</span><span class="Punctuation">)</span>
    814. 

  814. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;good&quot;</span><span class="Punctuation">,</span> <span class="Identifier">s</span><span class="Punctuation">)</span>
    815. 

  815. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;good&gt;b text&lt;/good&gt;]&quot;</span>
    816. 

  816. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">setLen</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span>
    817. 

  817. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;good&quot;</span><span class="Punctuation">,</span> <span class="Identifier">s</span><span class="Punctuation">,</span> <span class="Identifier">caseInsensitive</span> <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">)</span>
    818. 

  818. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;good&gt;b text&lt;/good&gt;, &lt;GOOD&gt;e text&lt;/GOOD&gt;]&quot;</span>
    819. 

  819. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">setLen</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span>
    820. 

  820. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;BAD&quot;</span><span class="Punctuation">,</span> <span class="Identifier">s</span><span class="Punctuation">)</span>
    821. 

  821. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;BAD&gt;d text&lt;/BAD&gt;]&quot;</span>
    822. 

  822. <span class="Identifier">s</span><span class="Operator">.</span><span class="Identifier">setLen</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">)</span>
    823. 

  823. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">findAll</span><span class="Punctuation">(</span><span class="StringLit">&quot;BAD&quot;</span><span class="Punctuation">,</span> <span class="Identifier">s</span><span class="Punctuation">,</span> <span class="Identifier">caseInsensitive</span> <span class="Operator">=</span> <span class="Identifier">true</span><span class="Punctuation">)</span>
    824. 

  824. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">s</span> <span class="Operator">==</span> <span class="StringLit">&quot;@[&lt;bad&gt;c text&lt;/bad&gt;, &lt;BAD&gt;d text&lt;/BAD&gt;]&quot;</span></pre>
    825. 

  825.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L854" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    826. 

  826. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L854" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    827. 

  827. 

  828.   </dd>
    829. 

  829. </div>
    830. 

  830. 

  831. </div>
    832. 

  832. <div id="innerText-procs-all">
    833. 

  833.   <div id="innerText,XmlNode">
    834. 

  834.   <dt><pre><span class="Keyword">proc</span> <a href="#innerText%2CXmlNode"><span class="Identifier">innerText</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    835. 

  835.   <dd>
    836. 

  836.     
    837. 

  837.     Gets the inner text of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>:<ul class="simple"><li>If <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> is <tt class="docutils literal"><span class="pre"><span class="Identifier">xnText</span></span></tt> or <tt class="docutils literal"><span class="pre"><span class="Identifier">xnEntity</span></span></tt>, returns its content.</li>
    838. 

  838. <li>If <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> is <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt>, runs recursively on each child node and concatenates the results.</li>
    839. 

  839. <li>Otherwise returns an empty string.</li>
    840. 

  840. </ul>
    841. 

  841. <p>See also:</p>
    842. 

  842. <ul class="simple"><li><a class="reference external" href="#text,XmlNode">text proc</a></li>
    843. 

  843. </ul>
    844. 

  844. 

  845. <p><strong class="examples_text">Example:</strong></p>
    846. 

  846. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    847. 

  847. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;my text&quot;</span><span class="Punctuation">)</span>
    848. 

  848. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;my comment&quot;</span><span class="Punctuation">)</span>
    849. 

  849. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;my entity&quot;</span><span class="Punctuation">)</span>
    850. 

  850. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;myTag&gt;my text&lt;!-- my comment --&gt;&amp;my entity;&lt;/myTag&gt;&quot;</span>
    851. 

  851. <span class="Identifier">assert</span> <span class="Identifier">innerText</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="StringLit">&quot;my textmy entity&quot;</span></pre>
    852. 

  852.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L276" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    853. 

  853. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L276" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    854. 

  854. 

  855.   </dd>
    856. 

  856. </div>
    857. 

  857. 

  858. </div>
    859. 

  859. <div id="insert-procs-all">
    860. 

  860.   <div id="insert,XmlNode,XmlNode,int">
    861. 

  861.   <dt><pre><span class="Keyword">proc</span> <a href="#insert%2CXmlNode%2CXmlNode%2Cint"><span class="Identifier">insert</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">,</span> <span class="Identifier">son</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">index</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    862. 

  862.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    863. 

  863.   <dd>
    864. 

  864.     
    865. 

  865.     <p>Inserts the child <tt class="docutils literal"><span class="pre"><span class="Identifier">son</span></span></tt> to a given position in <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt>.</p>
    866. 

  866. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> must be of <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt> kind.</p>
    867. 

  867. <p>See also:</p>
    868. 

  868. <ul class="simple"><li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    869. 

  869. <li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    870. 

  870. <li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    871. 

  871. <li><a class="reference external" href="#delete,XmlNode,Natural">delete proc</a></li>
    872. 

  872. <li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    873. 

  873. <li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    874. 

  874. <li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    875. 

  875. </ul>
    876. 

  876. 

  877. <p><strong class="examples_text">Example:</strong></p>
    878. 

  878. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    879. 

  879. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    880. 

  880. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    881. 

  881. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag&gt;
    882. 

  882.   &lt;second /&gt;
    883. 

  883.   &lt;first /&gt;
    884. 

  884. &lt;/myTag&gt;&quot;&quot;&quot;</span></pre>
    885. 

  885.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L350" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    886. 

  886. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L350" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    887. 

  887. 

  888.   </dd>
    889. 

  889. </div>
    890. 

  890. <div id="insert,XmlNode,openArray[XmlNode],int">
    891. 

  891.   <dt><pre><span class="Keyword">proc</span> <a href="#insert%2CXmlNode%2CopenArray%5BXmlNode%5D%2Cint"><span class="Identifier">insert</span></a><span class="Other">(</span><span class="Identifier">father</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">sons</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">index</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span>
    892. 

  892.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    893. 

  893.   <dd>
    894. 

  894.     
    895. 

  895.     <p>Inserts the children openArray<a class="reference internal" href="#`sons`">`sons`</a> to a given position in <tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt>.</p>
    896. 

  896. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">father</span></span></tt> must be of <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt> kind.</p>
    897. 

  897. <p>See also:</p>
    898. 

  898. <ul class="simple"><li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    899. 

  899. <li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    900. 

  900. <li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    901. 

  901. <li><a class="reference external" href="#delete,XmlNode,Natural">delete proc</a></li>
    902. 

  902. <li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    903. 

  903. <li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    904. 

  904. <li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    905. 

  905. </ul>
    906. 

  906. 

  907. <p><strong class="examples_text">Example:</strong></p>
    908. 

  908. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    909. 

  909. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    910. 

  910. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Punctuation">[</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;third&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    911. 

  911. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag&gt;
    912. 

  912.   &lt;second /&gt;
    913. 

  913.   &lt;third /&gt;
    914. 

  914.   &lt;first /&gt;
    915. 

  915. &lt;/myTag&gt;&quot;&quot;&quot;</span></pre>
    916. 

  916.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L378" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    917. 

  917. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L378" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    918. 

  918. 

  919.   </dd>
    920. 

  920. </div>
    921. 

  921. 

  922. </div>
    923. 

  923. <div id="kind-procs-all">
    924. 

  924.   <div id="kind,XmlNode">
    925. 

  925.   <dt><pre><span class="Keyword">proc</span> <a href="#kind%2CXmlNode"><span class="Identifier">kind</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNodeKind"><span class="Identifier">XmlNodeKind</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    926. 

  926.   <dd>
    927. 

  927.     
    928. 

  928.     Returns <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s kind.
    929. 

  929. <p><strong class="examples_text">Example:</strong></p>
    930. 

  930. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;firstTag&quot;</span><span class="Punctuation">)</span>
    931. 

  931. <span class="Identifier">assert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnElement</span>
    932. 

  932. <span class="Keyword">var</span> <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;my text&quot;</span><span class="Punctuation">)</span>
    933. 

  933. <span class="Identifier">assert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnText</span></pre>
    934. 

  934.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L519" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    935. 

  935. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L519" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    936. 

  936. 

  937.   </dd>
    938. 

  938. </div>
    939. 

  939. 

  940. </div>
    941. 

  941. <div id="len-procs-all">
    942. 

  942.   <div id="len,XmlNode">
    943. 

  943.   <dt><pre><span class="Keyword">proc</span> <a href="#len%2CXmlNode"><span class="Identifier">len</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#int"><span class="Identifier">int</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    944. 

  944.   <dd>
    945. 

  945.     
    946. 

  946.     Returns the number of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>'s children.
    947. 

  947. <p><strong class="examples_text">Example:</strong></p>
    948. 

  948. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    949. 

  949. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    950. 

  950. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    951. 

  951. <span class="Identifier">assert</span> <span class="Identifier">len</span><span class="Punctuation">(</span><span class="Identifier">f</span><span class="Punctuation">)</span> <span class="Operator">==</span> <span class="DecNumber">2</span></pre>
    952. 

  952.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L509" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    953. 

  953. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L509" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    954. 

  954. 

  955.   </dd>
    956. 

  956. </div>
    957. 

  957. 

  958. </div>
    959. 

  959. <div id="newCData-procs-all">
    960. 

  960.   <div id="newCData,sinkstring">
    961. 

  961.   <dt><pre><span class="Keyword">proc</span> <a href="#newCData%2Csinkstring"><span class="Identifier">newCData</span></a><span class="Other">(</span><span class="Identifier">cdata</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    962. 

  962.   <dd>
    963. 

  963.     
    964. 

  964.     Creates a new <tt class="docutils literal"><span class="pre">XmlNode</span></tt> of kind <tt class="docutils literal"><span class="pre">xnCData</span></tt> with the text <tt class="docutils literal"><span class="pre"><span class="Identifier">cdata</span></span></tt>.
    965. 

  965. <p><strong class="examples_text">Example:</strong></p>
    966. 

  966. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">d</span> <span class="Operator">=</span> <span class="Identifier">newCData</span><span class="Punctuation">(</span><span class="StringLit">&quot;my cdata&quot;</span><span class="Punctuation">)</span>
    967. 

  967. <span class="Identifier">assert</span> <span class="Identifier">d</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnCData</span>
    968. 

  968. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">d</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;![CDATA[my cdata]]&gt;&quot;</span></pre>
    969. 

  969.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L130" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    970. 

  970. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L130" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    971. 

  971. 

  972.   </dd>
    973. 

  973. </div>
    974. 

  974. 

  975. </div>
    976. 

  976. <div id="newComment-procs-all">
    977. 

  977.   <div id="newComment,sinkstring">
    978. 

  978.   <dt><pre><span class="Keyword">proc</span> <a href="#newComment%2Csinkstring"><span class="Identifier">newComment</span></a><span class="Other">(</span><span class="Identifier">comment</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    979. 

  979.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    980. 

  980.   <dd>
    981. 

  981.     
    982. 

  982.     Creates a new <tt class="docutils literal"><span class="pre">XmlNode</span></tt> of kind <tt class="docutils literal"><span class="pre">xnComment</span></tt> with the text <tt class="docutils literal"><span class="pre"><span class="Identifier">comment</span></span></tt>.
    983. 

  983. <p><strong class="examples_text">Example:</strong></p>
    984. 

  984. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">c</span> <span class="Operator">=</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;my comment&quot;</span><span class="Punctuation">)</span>
    985. 

  985. <span class="Identifier">assert</span> <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnComment</span>
    986. 

  986. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">c</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;!-- my comment --&gt;&quot;</span></pre>
    987. 

  987.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L120" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    988. 

  988. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L120" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    989. 

  989. 

  990.   </dd>
    991. 

  991. </div>
    992. 

  992. 

  993. </div>
    994. 

  994. <div id="newElement-procs-all">
    995. 

  995.   <div id="newElement,sinkstring">
    996. 

  996.   <dt><pre><span class="Keyword">proc</span> <a href="#newElement%2Csinkstring"><span class="Identifier">newElement</span></a><span class="Other">(</span><span class="Identifier">tag</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    997. 

  997.   <dd>
    998. 

  998.     
    999. 

  999.     <p>Creates a new <tt class="docutils literal"><span class="pre">XmlNode</span></tt> of kind <tt class="docutils literal"><span class="pre">xnElement</span></tt> with the given <tt class="docutils literal"><span class="pre"><span class="Identifier">tag</span></span></tt>.</p>
    1000. 

  1000. <p>See also:</p>
    1001. 

  1001. <ul class="simple"><li><a class="reference external" href="#newXmlTree,string,openArray[XmlNode],XmlAttributes">newXmlTree proc</a></li>
    1002. 

  1002. <li><a class="reference external" href="#&lt;&gt;.m,untyped">&lt;&gt; macro</a></li>
    1003. 

  1003. </ul>
    1004. 

  1004. 

  1005. <p><strong class="examples_text">Example:</strong></p>
    1006. 

  1006. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;firstTag&quot;</span><span class="Punctuation">)</span>
    1007. 

  1007. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;childTag&quot;</span><span class="Punctuation">)</span>
    1008. 

  1008. <span class="Identifier">assert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnElement</span>
    1009. 

  1009. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">a</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;firstTag&gt;
    1010. 

  1010.   &lt;childTag /&gt;
    1011. 

  1011. &lt;/firstTag&gt;&quot;&quot;&quot;</span></pre>
    1012. 

  1012.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L85" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1013. 

  1013. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L85" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1014. 

  1014. 

  1015.   </dd>
    1016. 

  1016. </div>
    1017. 

  1017. 

  1018. </div>
    1019. 

  1019. <div id="newEntity-procs-all">
    1020. 

  1020.   <div id="newEntity,string">
    1021. 

  1021.   <dt><pre><span class="Keyword">proc</span> <a href="#newEntity%2Cstring"><span class="Identifier">newEntity</span></a><span class="Other">(</span><span class="Identifier">entity</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1022. 

  1022.   <dd>
    1023. 

  1023.     
    1024. 

  1024.     Creates a new <tt class="docutils literal"><span class="pre">XmlNode</span></tt> of kind <tt class="docutils literal"><span class="pre">xnEntity</span></tt> with the text <tt class="docutils literal"><span class="pre"><span class="Identifier">entity</span></span></tt>.
    1025. 

  1025. <p><strong class="examples_text">Example:</strong></p>
    1026. 

  1026. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">e</span> <span class="Operator">=</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;my entity&quot;</span><span class="Punctuation">)</span>
    1027. 

  1027. <span class="Identifier">assert</span> <span class="Identifier">e</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnEntity</span>
    1028. 

  1028. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">e</span> <span class="Operator">==</span> <span class="StringLit">&quot;&amp;my entity;&quot;</span></pre>
    1029. 

  1029.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L140" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1030. 

  1030. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L140" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1031. 

  1031. 

  1032.   </dd>
    1033. 

  1033. </div>
    1034. 

  1034. 

  1035. </div>
    1036. 

  1036. <div id="newText-procs-all">
    1037. 

  1037.   <div id="newText,sinkstring">
    1038. 

  1038.   <dt><pre><span class="Keyword">proc</span> <a href="#newText%2Csinkstring"><span class="Identifier">newText</span></a><span class="Other">(</span><span class="Identifier">text</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1039. 

  1039.   <dd>
    1040. 

  1040.     
    1041. 

  1041.     Creates a new <tt class="docutils literal"><span class="pre">XmlNode</span></tt> of kind <tt class="docutils literal"><span class="pre">xnText</span></tt> with the text <tt class="docutils literal"><span class="pre"><span class="Identifier">text</span></span></tt>.
    1042. 

  1042. <p><strong class="examples_text">Example:</strong></p>
    1043. 

  1043. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">b</span> <span class="Operator">=</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;my text&quot;</span><span class="Punctuation">)</span>
    1044. 

  1044. <span class="Identifier">assert</span> <span class="Identifier">b</span><span class="Operator">.</span><span class="Identifier">kind</span> <span class="Operator">==</span> <span class="Identifier">xnText</span>
    1045. 

  1045. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">b</span> <span class="Operator">==</span> <span class="StringLit">&quot;my text&quot;</span></pre>
    1046. 

  1046.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L104" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1047. 

  1047. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L104" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1048. 

  1048. 

  1049.   </dd>
    1050. 

  1050. </div>
    1051. 

  1051. 

  1052. </div>
    1053. 

  1053. <div id="newVerbatimText-procs-all">
    1054. 

  1054.   <div id="newVerbatimText,sinkstring">
    1055. 

  1055.   <dt><pre><span class="Keyword">proc</span> <a href="#newVerbatimText%2Csinkstring"><span class="Identifier">newVerbatimText</span></a><span class="Other">(</span><span class="Identifier">text</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1056. 

  1056.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1057. 

  1057.   <dd>
    1058. 

  1058.     
    1059. 

  1059.     Creates a new <tt class="docutils literal"><span class="pre">XmlNode</span></tt> of kind <tt class="docutils literal"><span class="pre">xnVerbatimText</span></tt> with the text <tt class="docutils literal"><span class="pre"><span class="Identifier">text</span></span></tt>. <strong>Since</strong>: Version 1.3.
    1060. 

  1060.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L114" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1061. 

  1061. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L114" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1062. 

  1062. 

  1063.   </dd>
    1064. 

  1064. </div>
    1065. 

  1065. 

  1066. </div>
    1067. 

  1067. <div id="newXmlTree-procs-all">
    1068. 

  1068.   <div id="newXmlTree,sinkstring,openArray[XmlNode],XmlAttributes">
    1069. 

  1069.   <dt><pre><span class="Keyword">proc</span> <a href="#newXmlTree%2Csinkstring%2CopenArray%5BXmlNode%5D%2CXmlAttributes"><span class="Identifier">newXmlTree</span></a><span class="Other">(</span><span class="Identifier">tag</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">;</span> <span class="Identifier">children</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span><span class="Other">;</span>
    1070. 

  1070.                 <span class="Identifier">attributes</span><span class="Other">:</span> <a href="xmltree.html#XmlAttributes"><span class="Identifier">XmlAttributes</span></a> <span class="Other">=</span> <span class="Keyword">nil</span><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1071. 

  1071.     <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1072. 

  1072.   <dd>
    1073. 

  1073.     
    1074. 

  1074.     <p>Creates a new XML tree with <tt class="docutils literal"><span class="pre"><span class="Identifier">tag</span></span></tt>, <tt class="docutils literal"><span class="pre"><span class="Identifier">children</span></span></tt> and <tt class="docutils literal"><span class="pre"><span class="Identifier">attributes</span></span></tt>.</p>
    1075. 

  1075. <p>See also:</p>
    1076. 

  1076. <ul class="simple"><li><a class="reference external" href="#newElement,string">newElement proc</a></li>
    1077. 

  1077. <li><a class="reference external" href="#&lt;&gt;.m,untyped">&lt;&gt; macro</a></li>
    1078. 

  1078. </ul>
    1079. 

  1079. 

  1080. <p><strong class="examples_text">Example:</strong></p>
    1081. 

  1081. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">g</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    1082. 

  1082. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;some text&quot;</span><span class="Punctuation">)</span>
    1083. 

  1083. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;this is comment&quot;</span><span class="Punctuation">)</span>
    1084. 

  1084. <span class="Keyword">var</span> <span class="Identifier">h</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;secondTag&quot;</span><span class="Punctuation">)</span>
    1085. 

  1085. <span class="Identifier">h</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;some entity&quot;</span><span class="Punctuation">)</span>
    1086. 

  1086. <span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    1087. 

  1087. <span class="Keyword">let</span> <span class="Identifier">k</span> <span class="Operator">=</span> <span class="Identifier">newXmlTree</span><span class="Punctuation">(</span><span class="StringLit">&quot;treeTag&quot;</span><span class="Punctuation">,</span> <span class="Punctuation">[</span><span class="Identifier">g</span><span class="Punctuation">,</span> <span class="Identifier">h</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="Identifier">att</span><span class="Punctuation">)</span>
    1088. 

  1088. 

  1089. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">k</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;treeTag key1=&quot;first value&quot; key2=&quot;second value&quot;&gt;
    1090. 

  1090.   &lt;myTag&gt;some text&lt;!-- this is comment --&gt;&lt;/myTag&gt;
    1091. 

  1091.   &lt;secondTag&gt;&amp;some entity;&lt;/secondTag&gt;
    1092. 

  1092. &lt;/treeTag&gt;&quot;&quot;&quot;</span></pre>
    1093. 

  1093.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L150" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1094. 

  1094. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L150" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1095. 

  1095. 

  1096.   </dd>
    1097. 

  1097. </div>
    1098. 

  1098. 

  1099. </div>
    1100. 

  1100. <div id="rawTag-procs-all">
    1101. 

  1101.   <div id="rawTag,XmlNode">
    1102. 

  1102.   <dt><pre><span class="Keyword">proc</span> <a href="#rawTag%2CXmlNode"><span class="Identifier">rawTag</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1103. 

  1103.   <dd>
    1104. 

  1104.     
    1105. 

  1105.     <p>Returns the underlying 'tag' string by reference.</p>
    1106. 

  1106. <p>This is only used for speed hacks.</p>
    1107. 

  1107. 

  1108.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L267" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1109. 

  1109. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L267" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1110. 

  1110. 

  1111.   </dd>
    1112. 

  1112. </div>
    1113. 

  1113. 

  1114. </div>
    1115. 

  1115. <div id="rawText-procs-all">
    1116. 

  1116.   <div id="rawText,XmlNode">
    1117. 

  1117.   <dt><pre><span class="Keyword">proc</span> <a href="#rawText%2CXmlNode"><span class="Identifier">rawText</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1118. 

  1118.   <dd>
    1119. 

  1119.     
    1120. 

  1120.     <p>Returns the underlying 'text' string by reference.</p>
    1121. 

  1121. <p>This is only used for speed hacks.</p>
    1122. 

  1122. 

  1123.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L258" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1124. 

  1124. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L258" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1125. 

  1125. 

  1126.   </dd>
    1127. 

  1127. </div>
    1128. 

  1128. 

  1129. </div>
    1130. 

  1130. <div id="replace-procs-all">
    1131. 

  1131.   <div id="replace,XmlNode,Natural,openArray[XmlNode]">
    1132. 

  1132.   <dt><pre><span class="Keyword">proc</span> <a href="#replace%2CXmlNode%2CNatural%2CopenArray%5BXmlNode%5D"><span class="Identifier">replace</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">i</span><span class="Other">:</span> <a href="system.html#Natural"><span class="Identifier">Natural</span></a><span class="Other">;</span> <span class="Identifier">replacement</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span><span class="Other">)</span> {.
    1133. 

  1133.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1134. 

  1134.   <dd>
    1135. 

  1135.     
    1136. 

  1136.     <p>Replaces the <tt class="docutils literal"><span class="pre"><span class="Identifier">i</span></span></tt>'th child of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> with <tt class="docutils literal"><span class="pre"><span class="Identifier">replacement</span></span></tt> openArray.</p>
    1137. 

  1137. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> must be of <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt> kind.</p>
    1138. 

  1138. <p>See also:</p>
    1139. 

  1139. <ul class="simple"><li><a class="reference external" href="#replace.XmlNode,Slice[int],openArray[XmlNode]">replace proc</a></li>
    1140. 

  1140. <li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    1141. 

  1141. <li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    1142. 

  1142. <li><a class="reference external" href="#delete,XmlNode,Natural">delete proc</a></li>
    1143. 

  1143. <li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    1144. 

  1144. <li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    1145. 

  1145. <li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    1146. 

  1146. </ul>
    1147. 

  1147. 

  1148. <p><strong class="examples_text">Example:</strong></p>
    1149. 

  1149. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    1150. 

  1150. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    1151. 

  1151. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    1152. 

  1152. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">replace</span><span class="Punctuation">(</span><span class="DecNumber">0</span><span class="Punctuation">,</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;third&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;fourth&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">)</span>
    1153. 

  1153. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag&gt;
    1154. 

  1154.   &lt;third /&gt;
    1155. 

  1155.   &lt;fourth /&gt;
    1156. 

  1156.   &lt;first /&gt;
    1157. 

  1157. &lt;/myTag&gt;&quot;&quot;&quot;</span></pre>
    1158. 

  1158.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L453" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1159. 

  1159. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L453" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1160. 

  1160. 

  1161.   </dd>
    1162. 

  1162. </div>
    1163. 

  1163. <div id="replace,XmlNode,Slice[int],openArray[XmlNode]">
    1164. 

  1164.   <dt><pre><span class="Keyword">proc</span> <a href="#replace%2CXmlNode%2CSlice%5Bint%5D%2CopenArray%5BXmlNode%5D"><span class="Identifier">replace</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">slice</span><span class="Other">:</span> <a href="system.html#Slice"><span class="Identifier">Slice</span></a><span class="Other">[</span><a href="system.html#int"><span class="Identifier">int</span></a><span class="Other">]</span><span class="Other">;</span> <span class="Identifier">replacement</span><span class="Other">:</span> <a href="system.html#openArray"><span class="Identifier">openArray</span></a><span class="Other">[</span><a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">]</span><span class="Other">)</span> {.
    1165. 

  1165.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1166. 

  1166.   <dd>
    1167. 

  1167.     
    1168. 

  1168.     <p>Deletes the items <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span><span class="Punctuation">[</span><span class="Identifier">slice</span><span class="Punctuation">]</span></span></tt> of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    1169. 

  1169. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> must be of <tt class="docutils literal"><span class="pre"><span class="Identifier">xnElement</span></span></tt> kind.</p>
    1170. 

  1170. <p>See also:</p>
    1171. 

  1171. <ul class="simple"><li><a class="reference external" href="#replace.XmlNode,int,openArray[XmlNode]">replace proc</a></li>
    1172. 

  1172. <li><a class="reference external" href="#add,XmlNode,XmlNode">add proc</a></li>
    1173. 

  1173. <li><a class="reference external" href="#add,XmlNode,openArray[XmlNode]">add proc</a></li>
    1174. 

  1174. <li><a class="reference external" href="#delete,XmlNode,Natural">delete proc</a></li>
    1175. 

  1175. <li><a class="reference external" href="#delete.XmlNode,Slice[int]">delete proc</a></li>
    1176. 

  1176. <li><a class="reference external" href="#insert,XmlNode,XmlNode,int">insert proc</a></li>
    1177. 

  1177. <li><a class="reference external" href="#insert,XmlNode,openArray[XmlNode],int">insert proc</a></li>
    1178. 

  1178. </ul>
    1179. 

  1179. 

  1180. <p><strong class="examples_text">Example:</strong></p>
    1181. 

  1181. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">f</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    1182. 

  1182. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;first&quot;</span><span class="Punctuation">)</span>
    1183. 

  1183. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">insert</span><span class="Punctuation">(</span><span class="Punctuation">[</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;second&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;fifth&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">,</span> <span class="DecNumber">0</span><span class="Punctuation">)</span>
    1184. 

  1184. <span class="Identifier">f</span><span class="Operator">.</span><span class="Identifier">replace</span><span class="Punctuation">(</span><span class="FloatNumber">0.</span><span class="Operator">.</span><span class="DecNumber">1</span><span class="Punctuation">,</span> <span class="Operator">@</span><span class="Punctuation">[</span><span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;third&quot;</span><span class="Punctuation">)</span><span class="Punctuation">,</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;fourth&quot;</span><span class="Punctuation">)</span><span class="Punctuation">]</span><span class="Punctuation">)</span>
    1185. 

  1185. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">f</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag&gt;
    1186. 

  1186.   &lt;third /&gt;
    1187. 

  1187.   &lt;fourth /&gt;
    1188. 

  1188.   &lt;first /&gt;
    1189. 

  1189. &lt;/myTag&gt;&quot;&quot;&quot;</span></pre>
    1190. 

  1190.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L481" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1191. 

  1191. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L481" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1192. 

  1192. 

  1193.   </dd>
    1194. 

  1194. </div>
    1195. 

  1195. 

  1196. </div>
    1197. 

  1197. <div id="tag-procs-all">
    1198. 

  1198.   <div id="tag,XmlNode">
    1199. 

  1199.   <dt><pre><span class="Keyword">proc</span> <a href="#tag%2CXmlNode"><span class="Identifier">tag</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#lent"><span class="Identifier">lent</span></a> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1200. 

  1200.   <dd>
    1201. 

  1201.     
    1202. 

  1202.     <p>Gets the tag name of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    1203. 

  1203. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> has to be an <tt class="docutils literal"><span class="pre">xnElement</span></tt> node.</p>
    1204. 

  1204. <p>See also:</p>
    1205. 

  1205. <ul class="simple"><li><a class="reference external" href="#text,XmlNode">text proc</a> for text getter</li>
    1206. 

  1206. <li><a class="reference external" href="#text=,XmlNode,string">text= proc</a> for text setter</li>
    1207. 

  1207. <li><a class="reference external" href="#tag=,XmlNode,string">tag= proc</a> for tag setter</li>
    1208. 

  1208. <li><a class="reference external" href="#innerText,XmlNode">innerText proc</a></li>
    1209. 

  1209. </ul>
    1210. 

  1210. 

  1211. <p><strong class="examples_text">Example:</strong></p>
    1212. 

  1212. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;firstTag&quot;</span><span class="Punctuation">)</span>
    1213. 

  1213. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;childTag&quot;</span><span class="Punctuation">)</span>
    1214. 

  1214. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">a</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;firstTag&gt;
    1215. 

  1215.   &lt;childTag /&gt;
    1216. 

  1216. &lt;/firstTag&gt;&quot;&quot;&quot;</span>
    1217. 

  1217. <span class="Identifier">assert</span> <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">tag</span> <span class="Operator">==</span> <span class="StringLit">&quot;firstTag&quot;</span></pre>
    1218. 

  1218.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L214" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1219. 

  1219. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L214" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1220. 

  1220. 

  1221.   </dd>
    1222. 

  1222. </div>
    1223. 

  1223. 

  1224. </div>
    1225. 

  1225. <div id="tag=-procs-all">
    1226. 

  1226.   <div id="tag=,XmlNode,sinkstring">
    1227. 

  1227.   <dt><pre><span class="Keyword">proc</span> <a href="#tag%3D%2CXmlNode%2Csinkstring"><span class="Identifier">tag=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">tag</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1228. 

  1228.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1229. 

  1229.   <dd>
    1230. 

  1230.     
    1231. 

  1231.     <p>Sets the tag name of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    1232. 

  1232. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> has to be an <tt class="docutils literal"><span class="pre">xnElement</span></tt> node.</p>
    1233. 

  1233. <p>See also:</p>
    1234. 

  1234. <ul class="simple"><li><a class="reference external" href="#text,XmlNode">text proc</a> for text getter</li>
    1235. 

  1235. <li><a class="reference external" href="#text=,XmlNode,string">text= proc</a> for text setter</li>
    1236. 

  1236. <li><a class="reference external" href="#tag,XmlNode">tag proc</a> for tag getter</li>
    1237. 

  1237. </ul>
    1238. 

  1238. 

  1239. <p><strong class="examples_text">Example:</strong></p>
    1240. 

  1240. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">a</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;firstTag&quot;</span><span class="Punctuation">)</span>
    1241. 

  1241. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;childTag&quot;</span><span class="Punctuation">)</span>
    1242. 

  1242. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">a</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;firstTag&gt;
    1243. 

  1243.   &lt;childTag /&gt;
    1244. 

  1244. &lt;/firstTag&gt;&quot;&quot;&quot;</span>
    1245. 

  1245. <span class="Identifier">a</span><span class="Operator">.</span><span class="Identifier">tag</span> <span class="Operator">=</span> <span class="StringLit">&quot;newTag&quot;</span>
    1246. 

  1246. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">a</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;newTag&gt;
    1247. 

  1247.   &lt;childTag /&gt;
    1248. 

  1248. &lt;/newTag&gt;&quot;&quot;&quot;</span></pre>
    1249. 

  1249.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L235" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1250. 

  1250. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L235" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1251. 

  1251. 

  1252.   </dd>
    1253. 

  1253. </div>
    1254. 

  1254. 

  1255. </div>
    1256. 

  1256. <div id="text-procs-all">
    1257. 

  1257.   <div id="text,XmlNode">
    1258. 

  1258.   <dt><pre><span class="Keyword">proc</span> <a href="#text%2CXmlNode"><span class="Identifier">text</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#lent"><span class="Identifier">lent</span></a> <a href="system.html#string"><span class="Identifier">string</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1259. 

  1259.   <dd>
    1260. 

  1260.     
    1261. 

  1261.     <p>Gets the associated text with the node <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    1262. 

  1262. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> can be a CDATA, Text, comment, or entity node.</p>
    1263. 

  1263. <p>See also:</p>
    1264. 

  1264. <ul class="simple"><li><a class="reference external" href="#text=,XmlNode,string">text= proc</a> for text setter</li>
    1265. 

  1265. <li><a class="reference external" href="#tag,XmlNode">tag proc</a> for tag getter</li>
    1266. 

  1266. <li><a class="reference external" href="#tag=,XmlNode,string">tag= proc</a> for tag setter</li>
    1267. 

  1267. <li><a class="reference external" href="#innerText,XmlNode">innerText proc</a></li>
    1268. 

  1268. </ul>
    1269. 

  1269. 

  1270. <p><strong class="examples_text">Example:</strong></p>
    1271. 

  1271. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">c</span> <span class="Operator">=</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;my comment&quot;</span><span class="Punctuation">)</span>
    1272. 

  1272. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">c</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;!-- my comment --&gt;&quot;</span>
    1273. 

  1273. <span class="Identifier">assert</span> <span class="Identifier">c</span><span class="Operator">.</span><span class="Identifier">text</span> <span class="Operator">==</span> <span class="StringLit">&quot;my comment&quot;</span></pre>
    1274. 

  1274.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L178" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1275. 

  1275. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L178" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1276. 

  1276. 

  1277.   </dd>
    1278. 

  1278. </div>
    1279. 

  1279. 

  1280. </div>
    1281. 

  1281. <div id="text=-procs-all">
    1282. 

  1282.   <div id="text=,XmlNode,sinkstring">
    1283. 

  1283.   <dt><pre><span class="Keyword">proc</span> <a href="#text%3D%2CXmlNode%2Csinkstring"><span class="Identifier">text=</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">;</span> <span class="Identifier">text</span><span class="Other">:</span> <a href="system.html#sink"><span class="Identifier">sink</span></a> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">)</span> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1284. 

  1284.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1285. 

  1285.   <dd>
    1286. 

  1286.     
    1287. 

  1287.     <p>Sets the associated text with the node <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.</p>
    1288. 

  1288. <p><tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> can be a CDATA, Text, comment, or entity node.</p>
    1289. 

  1289. <p>See also:</p>
    1290. 

  1290. <ul class="simple"><li><a class="reference external" href="#text,XmlNode">text proc</a> for text getter</li>
    1291. 

  1291. <li><a class="reference external" href="#tag,XmlNode">tag proc</a> for tag getter</li>
    1292. 

  1292. <li><a class="reference external" href="#tag=,XmlNode,string">tag= proc</a> for tag setter</li>
    1293. 

  1293. </ul>
    1294. 

  1294. 

  1295. <p><strong class="examples_text">Example:</strong></p>
    1296. 

  1296. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">e</span> <span class="Operator">=</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;my entity&quot;</span><span class="Punctuation">)</span>
    1297. 

  1297. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">e</span> <span class="Operator">==</span> <span class="StringLit">&quot;&amp;my entity;&quot;</span>
    1298. 

  1298. <span class="Identifier">e</span><span class="Operator">.</span><span class="Identifier">text</span> <span class="Operator">=</span> <span class="StringLit">&quot;a new entity text&quot;</span>
    1299. 

  1299. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">e</span> <span class="Operator">==</span> <span class="StringLit">&quot;&amp;a new entity text;&quot;</span></pre>
    1300. 

  1300.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L196" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1301. 

  1301. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L196" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1302. 

  1302. 

  1303.   </dd>
    1304. 

  1304. </div>
    1305. 

  1305. 

  1306. </div>
    1307. 

  1307. <div id="toXmlAttributes-procs-all">
    1308. 

  1308.   <div id="toXmlAttributes,varargs[tuple[string,string]]">
    1309. 

  1309.   <dt><pre><span class="Keyword">proc</span> <a href="#toXmlAttributes%2Cvarargs%5Btuple%5Bstring%2Cstring%5D%5D"><span class="Identifier">toXmlAttributes</span></a><span class="Other">(</span><span class="Identifier">keyValuePairs</span><span class="Other">:</span> <a href="system.html#varargs"><span class="Identifier">varargs</span></a><span class="Other">[</span><span class="Keyword">tuple</span><span class="Other">[</span><span class="Identifier">key</span><span class="Other">,</span> <span class="Identifier">val</span><span class="Other">:</span> <a href="system.html#string"><span class="Identifier">string</span></a><span class="Other">]</span><span class="Other">]</span><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlAttributes"><span class="Identifier">XmlAttributes</span></a> {.
    1310. 

  1310.     <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1311. 

  1311.   <dd>
    1312. 

  1312.     
    1313. 

  1313.     Converts <tt class="docutils literal"><span class="pre"><span class="Punctuation">{</span><span class="Identifier">key</span><span class="Punctuation">:</span> <span class="Identifier">value</span><span class="Punctuation">}</span></span></tt> pairs into <tt class="docutils literal"><span class="pre"><span class="Identifier">XmlAttributes</span></span></tt>. 
    1314. 

  1314. <p><strong class="examples_text">Example:</strong></p>
    1315. 

  1315. <pre class="listing"><span class="Keyword">let</span> <span class="Identifier">att</span> <span class="Operator">=</span> <span class="Punctuation">{</span><span class="StringLit">&quot;key1&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;first value&quot;</span><span class="Punctuation">,</span> <span class="StringLit">&quot;key2&quot;</span><span class="Punctuation">:</span> <span class="StringLit">&quot;second value&quot;</span><span class="Punctuation">}</span><span class="Operator">.</span><span class="Identifier">toXmlAttributes</span>
    1316. 

  1316. <span class="Keyword">var</span> <span class="Identifier">j</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    1317. 

  1317. <span class="Identifier">j</span><span class="Operator">.</span><span class="Identifier">attrs</span> <span class="Operator">=</span> <span class="Identifier">att</span>
    1318. 

  1318. 

  1319. <span class="Identifier">doAssert</span> <span class="Operator">$</span><span class="Identifier">j</span> <span class="Operator">==</span> <span class="LongStringLit">&quot;&quot;&quot;&lt;myTag key1=&quot;first value&quot; key2=&quot;second value&quot; /&gt;&quot;&quot;&quot;</span></pre>
    1320. 

  1320.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L602" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1321. 

  1321. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L602" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1322. 

  1322. 

  1323.   </dd>
    1324. 

  1324. </div>
    1325. 

  1325. 

  1326. </div>
    1327. 

  1327. 

  1328.   </dl>
    1329. 

  1329. </div>
    1330. 

  1330. <div class="section" id="15">
    1331. 

  1331.   <h1><a class="toc-backref" href="#15">Iterators</a></h1>
    1332. 

  1332.   <dl class="item">
    1333. 

  1333.     <div id="items-iterators-all">
    1334. 

  1334.   <div id="items.i,XmlNode">
    1335. 

  1335.   <dt><pre><span class="Keyword">iterator</span> <a href="#items.i%2CXmlNode"><span class="Identifier">items</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1336. 

  1336.   <dd>
    1337. 

  1337.     
    1338. 

  1338.     Iterates over all direct children of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt>.
    1339. 

  1339. <p><strong class="examples_text">Example:</strong></p>
    1340. 

  1340. <pre class="listing"><span class="Keyword">var</span> <span class="Identifier">g</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;myTag&quot;</span><span class="Punctuation">)</span>
    1341. 

  1341. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;some text&quot;</span><span class="Punctuation">)</span>
    1342. 

  1342. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newComment</span><span class="Punctuation">(</span><span class="StringLit">&quot;this is comment&quot;</span><span class="Punctuation">)</span>
    1343. 

  1343. 

  1344. <span class="Keyword">var</span> <span class="Identifier">h</span> <span class="Operator">=</span> <span class="Identifier">newElement</span><span class="Punctuation">(</span><span class="StringLit">&quot;secondTag&quot;</span><span class="Punctuation">)</span>
    1345. 

  1345. <span class="Identifier">h</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">newEntity</span><span class="Punctuation">(</span><span class="StringLit">&quot;some entity&quot;</span><span class="Punctuation">)</span>
    1346. 

  1346. <span class="Identifier">g</span><span class="Operator">.</span><span class="Identifier">add</span> <span class="Identifier">h</span>
    1347. 

  1347. 

  1348. <span class="Identifier">assert</span> <span class="Operator">$</span><span class="Identifier">g</span> <span class="Operator">==</span> <span class="StringLit">&quot;&lt;myTag&gt;some text&lt;!-- this is comment --&gt;&lt;secondTag&gt;&amp;some entity;&lt;/secondTag&gt;&lt;/myTag&gt;&quot;</span>
    1349. 

  1349. 

  1350. <span class="Comment"># for x in g: # the same as `for x in items(g):`</span>
    1351. 

  1351. <span class="Comment">#   echo x</span>
    1352. 

  1352. 

  1353. <span class="Comment"># some text</span>
    1354. 

  1354. <span class="Comment"># &lt;!-- this is comment --&gt;</span>
    1355. 

  1355. <span class="Comment"># &lt;secondTag&gt;&amp;some entity;&lt;![CDATA[some cdata]]&gt;&lt;/secondTag&gt;</span></pre>
    1356. 

  1356.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L573" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1357. 

  1357. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L573" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1358. 

  1358. 

  1359.   </dd>
    1360. 

  1360. </div>
    1361. 

  1361. 

  1362. </div>
    1363. 

  1363. <div id="mitems-iterators-all">
    1364. 

  1364.   <div id="mitems.i,XmlNode">
    1365. 

  1365.   <dt><pre><span class="Keyword">iterator</span> <a href="#mitems.i%2CXmlNode"><span class="Identifier">mitems</span></a><span class="Other">(</span><span class="Identifier">n</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a><span class="Other">)</span><span class="Other">:</span> <span class="Keyword">var</span> <a href="xmltree.html#XmlNode"><span class="Identifier">XmlNode</span></a> {.<span class="Identifier">inline</span><span class="Other">,</span> <span><span class="Other pragmadots">...</span></span><span class="pragmawrap"><span class="Identifier">raises</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span> <span class="Identifier">tags</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span><span class="Other">,</span>
    1366. 

  1366.     <span class="Identifier">forbids</span><span class="Other">:</span> <span class="Other">[</span><span class="Other">]</span></span>.}</pre></dt>
    1367. 

  1367.   <dd>
    1368. 

  1368.     
    1369. 

  1369.     Iterates over all direct children of <tt class="docutils literal"><span class="pre"><span class="Identifier">n</span></span></tt> so that they can be modified.
    1370. 

  1370.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L597" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1371. 

  1371. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L597" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1372. 

  1372. 

  1373.   </dd>
    1374. 

  1374. </div>
    1375. 

  1375. 

  1376. </div>
    1377. 

  1377. 

  1378.   </dl>
    1379. 

  1379. </div>
    1380. 

  1380. <div class="section" id="17">
    1381. 

  1381.   <h1><a class="toc-backref" href="#17">Macros</a></h1>
    1382. 

  1382.   <dl class="item">
    1383. 

  1383.     <div id="&lt;&gt;-macros-all">
    1384. 

  1384.   <div id="<>.m,untyped">
    1385. 

  1385.   <dt><pre><span class="Keyword">macro</span> <a href="#%3C%3E.m%2Cuntyped"><span class="Identifier">`&lt;&gt;`</span></a><span class="Other">(</span><span class="Identifier">x</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a><span class="Other">)</span><span class="Other">:</span> <a href="system.html#untyped"><span class="Identifier">untyped</span></a></pre></dt>
    1386. 

  1386.   <dd>
    1387. 

  1387.     
    1388. 

  1388.     <p>Constructor macro for XML. Example usage:</p>
    1389. 

  1389. <p><pre class="listing"><span class="Operator">&lt;&gt;</span><span class="Identifier">a</span><span class="Punctuation">(</span><span class="Identifier">href</span><span class="Operator">=</span><span class="StringLit">&quot;https://nim-lang.org&quot;</span><span class="Punctuation">,</span> <span class="Identifier">newText</span><span class="Punctuation">(</span><span class="StringLit">&quot;Nim rules.&quot;</span><span class="Punctuation">)</span><span class="Punctuation">)</span></pre></p>
    1390. 

  1390. <p>Produces an XML tree for:</p>
    1391. 

  1391. <pre>&lt;a href=&quot;https://nim-lang.org&quot;&gt;Nim rules.&lt;/a&gt;</pre>
    1392. 

  1392. 

  1393.     <a href="https://github.com/nim-lang/Nim/tree/devel/lib/pure/xmltree.nim#L938" class="link-seesrc" target="_blank">Source</a>&nbsp;&nbsp;
    1394. 

  1394. <a href="https://github.com/nim-lang/Nim/edit/devel/lib/pure/xmltree.nim#L938" class="link-seesrc" target="_blank" >Edit</a>&nbsp;&nbsp;
    1395. 

  1395. 

  1396.   </dd>
    1397. 

  1397. </div>
    1398. 

  1398. 

  1399. </div>
    1400. 

  1400. 

  1401.   </dl>
    1402. 

  1402. </div>
    1403. 

  1403. 

  1404.   </div>
    1405. 

  1405. </div>
    1406. 

  1406. 

  1407.       <div class="twelve-columns footer">
    1408. 

  1408.         <span class="nim-sprite"></span>
    1409. 

  1409.         <br>
    1410. 

  1410.         <small style="color: var(--hint);">Made with Nim. Generated: 2025-01-09 12:00:17 UTC</small>
    1411. 

  1411.       </div>
    1412. 

  1412.     </div>
    1413. 

  1413.   </div>
    1414. 

  1414.       <script defer data-domain="nim-lang.org" src="https://plausible.io/js/plausible.js"></script>
    1415. 

  1415.     
    1416. 

  1416. </body>
    1417. 

  1417. </html>
    1418. 

  1418.