Auth_Yadis_XMLParser.html 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <!-- template designed by Marco Von Ballmoos -->
  6. <title>Docs For Class Auth_Yadis_XMLParser</title>
  7. <link rel="stylesheet" href="../media/stylesheet.css" />
  8. <meta http-equiv='Content-Type' content='text/html; charset=iso-8859-1'/>
  9. </head>
  10. <body>
  11. <div class="page-body">
  12. <h2 class="class-name">Class Auth_Yadis_XMLParser</h2>
  13. <a name="sec-description"></a>
  14. <div class="info-box">
  15. <div class="info-box-title">Description</div>
  16. <div class="nav-bar">
  17. <span class="disabled">Description</span> |
  18. <a href="#sec-descendents">Descendents</a>
  19. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  20. </div>
  21. <div class="info-box-body">
  22. <!-- ========== Info from phpDoc block ========= -->
  23. <p class="short-description">The base class for wrappers for available PHP XML-parsing</p>
  24. <p class="description"><p>extensions. To work with this Yadis library, subclasses of this class MUST implement the API as defined in the remarks for this class. Subclasses of Auth_Yadis_XMLParser are used to wrap particular PHP XML extensions such as 'domxml'. These are used internally by the library depending on the availability of supported PHP XML extensions.</p></p>
  25. <p class="notes">
  26. Located in <a class="field" href="_Auth---Yadis---XML.php.html">/Auth/Yadis/XML.php</a> (line <span class="field">21</span>)
  27. </p>
  28. <pre></pre>
  29. </div>
  30. </div>
  31. <a name="sec-descendents"></a>
  32. <div class="info-box">
  33. <div class="info-box-title">Direct descendents</div>
  34. <div class="nav-bar">
  35. <a href="#sec-description">Description</a> |
  36. <span class="disabled">Descendents</span>
  37. | <a href="#sec-method-summary">Methods</a> (<a href="#sec-methods">details</a>)
  38. </div>
  39. <div class="info-box-body">
  40. <table cellpadding="2" cellspacing="0" class="class-table">
  41. <tr>
  42. <th class="class-table-header">Class</th>
  43. <th class="class-table-header">Description</th>
  44. </tr>
  45. <tr>
  46. <td style="padding-right: 2em"><a href="../OpenID/Auth_Yadis_domxml.html">Auth_Yadis_domxml</a></td>
  47. <td>
  48. This concrete implementation of Auth_Yadis_XMLParser implements
  49. </td>
  50. </tr>
  51. <tr>
  52. <td style="padding-right: 2em"><a href="../OpenID/Auth_Yadis_dom.html">Auth_Yadis_dom</a></td>
  53. <td>
  54. This concrete implementation of Auth_Yadis_XMLParser implements
  55. </td>
  56. </tr>
  57. </table>
  58. </div>
  59. </div>
  60. <a name="sec-method-summary"></a>
  61. <div class="info-box">
  62. <div class="info-box-title">Method Summary</span></div>
  63. <div class="nav-bar">
  64. <a href="#sec-description">Description</a> |
  65. <a href="#sec-descendents">Descendents</a> |
  66. <span class="disabled">Methods</span> (<a href="#sec-methods">details</a>)
  67. </div>
  68. <div class="info-box-body">
  69. <div class="method-summary">
  70. <div class="method-definition">
  71. <span class="method-result">array</span>
  72. <a href="#attributes" title="details" class="method-name">attributes</a>
  73. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$node</span>)
  74. </div>
  75. <div class="method-definition">
  76. <span class="method-result">string</span>
  77. <a href="#content" title="details" class="method-name">content</a>
  78. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$node</span>)
  79. </div>
  80. <div class="method-definition">
  81. <span class="method-result">array</span>
  82. <a href="#evalXPath" title="details" class="method-name">&amp;evalXPath</a>
  83. (<span class="var-type">string</span>&nbsp;<span class="var-name">$xpath</span>, [<span class="var-type">mixed</span>&nbsp;<span class="var-name">$node</span> = <span class="var-default">null</span>])
  84. </div>
  85. <div class="method-definition">
  86. <span class="method-result">boolean</span>
  87. <a href="#init" title="details" class="method-name">init</a>
  88. (<span class="var-type">string</span>&nbsp;<span class="var-name">$xml_string</span>, <span class="var-type">array</span>&nbsp;<span class="var-name">$namespace_map</span>)
  89. </div>
  90. <div class="method-definition">
  91. <span class="method-result">boolean</span>
  92. <a href="#registerNamespace" title="details" class="method-name">registerNamespace</a>
  93. (<span class="var-type">string</span>&nbsp;<span class="var-name">$prefix</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$uri</span>)
  94. </div>
  95. <div class="method-definition">
  96. <span class="method-result">boolean</span>
  97. <a href="#setXML" title="details" class="method-name">setXML</a>
  98. (<span class="var-type">string</span>&nbsp;<span class="var-name">$xml_string</span>)
  99. </div>
  100. </div>
  101. </div>
  102. </div>
  103. <a name="sec-methods"></a>
  104. <div class="info-box">
  105. <div class="info-box-title">Methods</div>
  106. <div class="nav-bar">
  107. <a href="#sec-description">Description</a> |
  108. <a href="#sec-descendents">Descendents</a> |
  109. <a href="#sec-method-summary">Methods</a> (<span class="disabled">details</span>)
  110. </div>
  111. <div class="info-box-body">
  112. <A NAME='method_detail'></A>
  113. <a name="methodattributes" id="attributes"><!-- --></a>
  114. <div class="oddrow">
  115. <div class="method-header">
  116. <span class="method-title">attributes</span> (line <span class="line-number">121</span>)
  117. </div>
  118. <!-- ========== Info from phpDoc block ========= -->
  119. <p class="short-description">Return the attributes of a specified node.</p>
  120. <ul class="tags">
  121. <li><span class="field">return:</span> An array mapping attribute names to values.</li>
  122. </ul>
  123. <div class="method-signature">
  124. <span class="method-result">array</span>
  125. <span class="method-name">
  126. attributes
  127. </span>
  128. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$node</span>)
  129. </div>
  130. <ul class="parameters">
  131. <li>
  132. <span class="var-type">mixed</span>
  133. <span class="var-name">$node</span><span class="var-description">: A node object from a previous call to $this-&gt;evalXPath().</span> </li>
  134. </ul>
  135. <hr class="separator" />
  136. <div class="notes">Redefined in descendants as:</div>
  137. <ul class="redefinitions">
  138. <li>
  139. <a href="../OpenID/Auth_Yadis_domxml.html#methodattributes">Auth_Yadis_domxml::attributes()</a>
  140. </li>
  141. <li>
  142. <a href="../OpenID/Auth_Yadis_dom.html#methodattributes">Auth_Yadis_dom::attributes()</a>
  143. </li>
  144. </ul>
  145. </div>
  146. <a name="methodcontent" id="content"><!-- --></a>
  147. <div class="evenrow">
  148. <div class="method-header">
  149. <span class="method-title">content</span> (line <span class="line-number">107</span>)
  150. </div>
  151. <!-- ========== Info from phpDoc block ========= -->
  152. <p class="short-description">Return the textual content of a specified node.</p>
  153. <ul class="tags">
  154. <li><span class="field">return:</span> The content of this node.</li>
  155. </ul>
  156. <div class="method-signature">
  157. <span class="method-result">string</span>
  158. <span class="method-name">
  159. content
  160. </span>
  161. (<span class="var-type">mixed</span>&nbsp;<span class="var-name">$node</span>)
  162. </div>
  163. <ul class="parameters">
  164. <li>
  165. <span class="var-type">mixed</span>
  166. <span class="var-name">$node</span><span class="var-description">: A node object from a previous call to $this-&gt;evalXPath().</span> </li>
  167. </ul>
  168. <hr class="separator" />
  169. <div class="notes">Redefined in descendants as:</div>
  170. <ul class="redefinitions">
  171. <li>
  172. <a href="../OpenID/Auth_Yadis_domxml.html#methodcontent">Auth_Yadis_domxml::content()</a>
  173. </li>
  174. <li>
  175. <a href="../OpenID/Auth_Yadis_dom.html#methodcontent">Auth_Yadis_dom::content()</a>
  176. </li>
  177. </ul>
  178. </div>
  179. <a name="methodevalXPath" id="evalXPath"><!-- --></a>
  180. <div class="oddrow">
  181. <div class="method-header">
  182. <span class="method-title">evalXPath</span> (line <span class="line-number">94</span>)
  183. </div>
  184. <!-- ========== Info from phpDoc block ========= -->
  185. <p class="short-description">Evaluate an XPath expression and return the resulting node list. This should be overridden by subclasses.</p>
  186. <ul class="tags">
  187. <li><span class="field">return:</span> An array of matching opaque node objects to be used with other methods of this parser class.</li>
  188. </ul>
  189. <div class="method-signature">
  190. <span class="method-result">array</span>
  191. <span class="method-name">
  192. &amp;evalXPath
  193. </span>
  194. (<span class="var-type">string</span>&nbsp;<span class="var-name">$xpath</span>, [<span class="var-type">mixed</span>&nbsp;<span class="var-name">$node</span> = <span class="var-default">null</span>])
  195. </div>
  196. <ul class="parameters">
  197. <li>
  198. <span class="var-type">string</span>
  199. <span class="var-name">$xpath</span><span class="var-description">: The XPath expression to be evaluated.</span> </li>
  200. <li>
  201. <span class="var-type">mixed</span>
  202. <span class="var-name">$node</span><span class="var-description">: A node object resulting from a previous evalXPath call. This node, if specified, provides the context for the evaluation of this xpath expression.</span> </li>
  203. </ul>
  204. <hr class="separator" />
  205. <div class="notes">Redefined in descendants as:</div>
  206. <ul class="redefinitions">
  207. <li>
  208. <a href="../OpenID/Auth_Yadis_domxml.html#methodevalXPath">Auth_Yadis_domxml::evalXPath()</a>
  209. </li>
  210. <li>
  211. <a href="../OpenID/Auth_Yadis_dom.html#methodevalXPath">Auth_Yadis_dom::evalXPath()</a>
  212. </li>
  213. </ul>
  214. </div>
  215. <a name="methodinit" id="init"><!-- --></a>
  216. <div class="evenrow">
  217. <div class="method-header">
  218. <span class="method-title">init</span> (line <span class="line-number">33</span>)
  219. </div>
  220. <!-- ========== Info from phpDoc block ========= -->
  221. <p class="short-description">Initialize an instance of Auth_Yadis_XMLParser with some XML and namespaces. This SHOULD NOT be overridden by subclasses.</p>
  222. <ul class="tags">
  223. <li><span class="field">return:</span> True if the initialization and namespace registration(s) succeeded; false otherwise.</li>
  224. </ul>
  225. <div class="method-signature">
  226. <span class="method-result">boolean</span>
  227. <span class="method-name">
  228. init
  229. </span>
  230. (<span class="var-type">string</span>&nbsp;<span class="var-name">$xml_string</span>, <span class="var-type">array</span>&nbsp;<span class="var-name">$namespace_map</span>)
  231. </div>
  232. <ul class="parameters">
  233. <li>
  234. <span class="var-type">string</span>
  235. <span class="var-name">$xml_string</span><span class="var-description">: A string of XML to be parsed.</span> </li>
  236. <li>
  237. <span class="var-type">array</span>
  238. <span class="var-name">$namespace_map</span><span class="var-description">: An array of ($ns_name =&gt; $ns_uri) to be registered with the XML parser. May be empty.</span> </li>
  239. </ul>
  240. </div>
  241. <a name="methodregisterNamespace" id="registerNamespace"><!-- --></a>
  242. <div class="oddrow">
  243. <div class="method-header">
  244. <span class="method-title">registerNamespace</span> (line <span class="line-number">61</span>)
  245. </div>
  246. <!-- ========== Info from phpDoc block ========= -->
  247. <p class="short-description">Register a namespace with the XML parser. This should be overridden by subclasses.</p>
  248. <ul class="tags">
  249. <li><span class="field">return:</span> True if the registration succeeded; false otherwise.</li>
  250. </ul>
  251. <div class="method-signature">
  252. <span class="method-result">boolean</span>
  253. <span class="method-name">
  254. registerNamespace
  255. </span>
  256. (<span class="var-type">string</span>&nbsp;<span class="var-name">$prefix</span>, <span class="var-type">string</span>&nbsp;<span class="var-name">$uri</span>)
  257. </div>
  258. <ul class="parameters">
  259. <li>
  260. <span class="var-type">string</span>
  261. <span class="var-name">$prefix</span><span class="var-description">: The namespace prefix to appear in XML tag names.</span> </li>
  262. <li>
  263. <span class="var-type">string</span>
  264. <span class="var-name">$uri</span><span class="var-description">: The namespace URI to be used to identify the namespace in the XML.</span> </li>
  265. </ul>
  266. <hr class="separator" />
  267. <div class="notes">Redefined in descendants as:</div>
  268. <ul class="redefinitions">
  269. <li>
  270. <a href="../OpenID/Auth_Yadis_domxml.html#methodregisterNamespace">Auth_Yadis_domxml::registerNamespace()</a>
  271. </li>
  272. <li>
  273. <a href="../OpenID/Auth_Yadis_dom.html#methodregisterNamespace">Auth_Yadis_dom::registerNamespace()</a>
  274. </li>
  275. </ul>
  276. </div>
  277. <a name="methodsetXML" id="setXML"><!-- --></a>
  278. <div class="evenrow">
  279. <div class="method-header">
  280. <span class="method-title">setXML</span> (line <span class="line-number">76</span>)
  281. </div>
  282. <!-- ========== Info from phpDoc block ========= -->
  283. <p class="short-description">Set this parser object's XML payload. This should be overridden by subclasses.</p>
  284. <ul class="tags">
  285. <li><span class="field">return:</span> True if the initialization succeeded; false otherwise.</li>
  286. </ul>
  287. <div class="method-signature">
  288. <span class="method-result">boolean</span>
  289. <span class="method-name">
  290. setXML
  291. </span>
  292. (<span class="var-type">string</span>&nbsp;<span class="var-name">$xml_string</span>)
  293. </div>
  294. <ul class="parameters">
  295. <li>
  296. <span class="var-type">string</span>
  297. <span class="var-name">$xml_string</span><span class="var-description">: The XML string to pass to this object's XML parser.</span> </li>
  298. </ul>
  299. <hr class="separator" />
  300. <div class="notes">Redefined in descendants as:</div>
  301. <ul class="redefinitions">
  302. <li>
  303. <a href="../OpenID/Auth_Yadis_domxml.html#methodsetXML">Auth_Yadis_domxml::setXML()</a>
  304. </li>
  305. <li>
  306. <a href="../OpenID/Auth_Yadis_dom.html#methodsetXML">Auth_Yadis_dom::setXML()</a>
  307. </li>
  308. </ul>
  309. </div>
  310. </div>
  311. </div>
  312. <p class="notes" id="credit">
  313. Documentation generated on Tue, 21 Apr 2009 11:31:33 -0700 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.3.2</a>
  314. </p>
  315. </div></body>
  316. </html>