doc/html/api/lxml.etree.ElementBase-class.html

   1 <?xml version="1.0" encoding="ascii"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   3           "DTD/xhtml1-transitional.dtd">
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   5 <head>
   6   <title>lxml.etree.ElementBase</title>
   7   <link rel="stylesheet" href="epydoc.css" type="text/css" />
   8   <script type="text/javascript" src="epydoc.js"></script>
   9 </head>
  10
  11 <body bgcolor="white" text="black" link="blue" vlink="#204080"
  12       alink="#204080">
  13 <!-- ==================== NAVIGATION BAR ==================== -->
  14 <table class="navbar" border="0" width="100%" cellpadding="0"
  15        bgcolor="#a0c0ff" cellspacing="0">
  16   <tr valign="middle">
  17   <!-- Home link -->
  18       <th>&nbsp;&nbsp;&nbsp;<a
  19         href="lxml-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
  20
  21   <!-- Tree link -->
  22       <th>&nbsp;&nbsp;&nbsp;<a
  23         href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
  24
  25   <!-- Index link -->
  26       <th>&nbsp;&nbsp;&nbsp;<a
  27         href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
  28
  29   <!-- Help link -->
  30       <th>&nbsp;&nbsp;&nbsp;<a
  31         href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
  32
  33   <!-- Project homepage -->
  34       <th class="navbar" align="right" width="100%">
  35         <table border="0" cellpadding="0" cellspacing="0">
  36           <tr><th class="navbar" align="center"
  37             ><a class="navbar" target="_top" href="/">lxml API</a></th>
  38           </tr></table></th>
  39   </tr>
  40 </table>
  41 <table width="100%" cellpadding="0" cellspacing="0">
  42   <tr valign="top">
  43     <td width="100%">
  44       <span class="breadcrumbs">
  45         <a href="lxml-module.html">Package&nbsp;lxml</a> ::
  46         <a href="lxml.etree-module.html">Module&nbsp;etree</a> ::
  47         Class&nbsp;ElementBase
  48       </span>
  49     </td>
  50     <td>
  51       <table cellpadding="0" cellspacing="0">
  52         <!-- hide/show private -->
  53         <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
  54     onclick="toggle_private();">hide&nbsp;private</a>]</span></td></tr>
  55         <tr><td align="right"><span class="options"
  56             >[<a href="frames.html" target="_top">frames</a
  57             >]&nbsp;|&nbsp;<a href="lxml.etree.ElementBase-class.html"
  58             target="_top">no&nbsp;frames</a>]</span></td></tr>
  59       </table>
  60     </td>
  61   </tr>
  62 </table>
  63 <!-- ==================== CLASS DESCRIPTION ==================== -->
  64 <h1 class="epydoc">Class ElementBase</h1><p class="nomargin-top"></p>
  65 <pre class="base-tree">
  66 object --+
  67          |
  68   <a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a> --+
  69              |
  70             <strong class="uidshort">ElementBase</strong>
  71 </pre>
  72
  73 <dl><dt>Known Subclasses:</dt>
  74 <dd>
  75       <ul class="subclass-list">
  76 <li><a href="lxml.html.HtmlElement-class.html">html.HtmlElement</a></li><li>, <a href="lxml.objectify.ObjectifiedElement-class.html">objectify.ObjectifiedElement</a></li><li>, <a href="lxml.tests.test_nsclasses.ETreeNamespaceClassesTestCase.bluff_class-class.html">tests.test_nsclasses.ETreeNamespaceClassesTestCase.bluff_class</a></li><li>, <a href="lxml.tests.test_nsclasses.ETreeNamespaceClassesTestCase.default_class-class.html">tests.test_nsclasses.ETreeNamespaceClassesTestCase.default_class</a></li><li>, <a href="lxml.tests.test_nsclasses.ETreeNamespaceClassesTestCase.maeh_class-class.html">tests.test_nsclasses.ETreeNamespaceClassesTestCase.maeh_class</a></li>  </ul>
  77 </dd></dl>
  78
  79 <hr />
  80 <p>ElementBase(<a href="#id1"><span class="rst-problematic" id="rst-rst-rst-id2">*</span></a>children, attrib=None, nsmap=None, <a href="#id3"><span class="rst-problematic" id="rst-rst-rst-id4">**</span></a>_extra)</p>
  81 <p>The public Element class.  All custom Element classes must inherit
  82 from this one.  To create an Element, use the <a href="lxml.etree-module.html#Element" class="link">Element()</a> factory.</p>
  83 <p>BIG FAT WARNING: Subclasses <em>must not</em> override __init__ or
  84 __new__ as it is absolutely undefined when these objects will be
  85 created or destroyed.  All persistent state of Elements must be
  86 stored in the underlying XML.  If you really need to initialize
  87 the object after creation, you can implement an <tt class="rst-docutils literal">_init(self)</tt>
  88 method that will be called directly after object creation.</p>
  89 <p>Subclasses of this class can be instantiated to create a new
  90 Element.  By default, the tag name will be the class name and the
  91 namespace will be empty.  You can modify this with the following
  92 class attributes:</p>
  93 <ul class="rst-simple">
  94 <li>TAG - the tag name, possibly containing a namespace in Clark
  95 notation</li>
  96 <li>NAMESPACE - the default namespace URI, unless provided as part
  97 of the TAG attribute.</li>
  98 <li>HTML - flag if the class is an HTML tag, as opposed to an XML
  99 tag.  This only applies to un-namespaced tags and defaults to
 100 false (i.e. XML).</li>
 101 <li>PARSER - the parser that provides the configuration for the
 102 newly created document.  Providing an HTML parser here will
 103 default to creating an HTML element.</li>
 104 </ul>
 105 <p>In user code, the latter three are commonly inherited in class
 106 hierarchies that implement a common namespace.</p>
 107
 108 <!-- ==================== INSTANCE METHODS ==================== -->
 109 <a name="section-InstanceMethods"></a>
 110 <table class="summary" border="1" cellpadding="3"
 111        cellspacing="0" width="100%" bgcolor="white">
 112 <tr bgcolor="#70b0f0" class="table-header">
 113   <td colspan="2" class="table-header">
 114     <table border="0" cellpadding="0" cellspacing="0" width="100%">
 115       <tr valign="top">
 116         <td align="left"><span class="table-header">Instance Methods</span></td>
 117         <td align="right" valign="top"
 118          ><span class="options">[<a href="#section-InstanceMethods"
 119          class="privatelink" onclick="toggle_private();"
 120          >hide private</a>]</span></td>
 121       </tr>
 122     </table>
 123   </td>
 124 </tr>
 125 <tr>
 126     <td width="15%" align="right" valign="top" class="summary">
 127       <span class="summary-type">&nbsp;</span>
 128     </td><td class="summary">
 129       <table width="100%" cellpadding="0" cellspacing="0" border="0">
 130         <tr>
 131           <td><span class="summary-sig"><a href="lxml.etree.ElementBase-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">attrib</span>=<span class="summary-sig-default">None</span>,
 132         <span class="summary-sig-arg">nsmap</span>=<span class="summary-sig-default">None</span>,
 133         <span class="summary-sig-arg">*children</span>,
 134         <span class="summary-sig-arg">**_extra</span>)</span><br />
 135       x.__init__(...) initializes x; see help(type(x)) for signature</td>
 136           <td align="right" valign="top">
 137
 138
 139           </td>
 140         </tr>
 141       </table>
 142
 143     </td>
 144   </tr>
 145 <tr>
 146     <td width="15%" align="right" valign="top" class="summary">
 147       <span class="summary-type">a new object with type S, a subtype of T</span>
 148     </td><td class="summary">
 149       <table width="100%" cellpadding="0" cellspacing="0" border="0">
 150         <tr>
 151           <td><span class="summary-sig"><a href="lxml.etree.ElementBase-class.html#__new__" class="summary-sig-name">__new__</a>(<span class="summary-sig-arg">T</span>,
 152         <span class="summary-sig-arg">S</span>,
 153         <span class="summary-sig-arg">...</span>)</span></td>
 154           <td align="right" valign="top">
 155
 156
 157           </td>
 158         </tr>
 159       </table>
 160
 161     </td>
 162   </tr>
 163   <tr>
 164     <td colspan="2" class="summary">
 165     <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a></code></b>:
 166       <code><a href="lxml.etree._Element-class.html#__contains__">__contains__</a></code>,
 167       <code><a href="lxml.etree._Element-class.html#__copy__">__copy__</a></code>,
 168       <code><a href="lxml.etree._Element-class.html#__deepcopy__">__deepcopy__</a></code>,
 169       <code><a href="lxml.etree._Element-class.html#__delitem__">__delitem__</a></code>,
 170       <code><a href="lxml.etree._Element-class.html#__getitem__">__getitem__</a></code>,
 171       <code><a href="lxml.etree._Element-class.html#__iter__">__iter__</a></code>,
 172       <code><a href="lxml.etree._Element-class.html#__len__">__len__</a></code>,
 173       <code><a href="lxml.etree._Element-class.html#__nonzero__">__nonzero__</a></code>,
 174       <code><a href="lxml.etree._Element-class.html#__repr__">__repr__</a></code>,
 175       <code><a href="lxml.etree._Element-class.html#__reversed__">__reversed__</a></code>,
 176       <code><a href="lxml.etree._Element-class.html#__setitem__">__setitem__</a></code>,
 177       <code><a href="lxml.etree._Element-class.html#addnext">addnext</a></code>,
 178       <code><a href="lxml.etree._Element-class.html#addprevious">addprevious</a></code>,
 179       <code><a href="lxml.etree._Element-class.html#append">append</a></code>,
 180       <code><a href="lxml.etree._Element-class.html#clear">clear</a></code>,
 181       <code><a href="lxml.etree._Element-class.html#cssselect">cssselect</a></code>,
 182       <code><a href="lxml.etree._Element-class.html#extend">extend</a></code>,
 183       <code><a href="lxml.etree._Element-class.html#find">find</a></code>,
 184       <code><a href="lxml.etree._Element-class.html#findall">findall</a></code>,
 185       <code><a href="lxml.etree._Element-class.html#findtext">findtext</a></code>,
 186       <code><a href="lxml.etree._Element-class.html#get">get</a></code>,
 187       <code><a href="lxml.etree._Element-class.html#getchildren">getchildren</a></code>,
 188       <code><a href="lxml.etree._Element-class.html#getiterator">getiterator</a></code>,
 189       <code><a href="lxml.etree._Element-class.html#getnext">getnext</a></code>,
 190       <code><a href="lxml.etree._Element-class.html#getparent">getparent</a></code>,
 191       <code><a href="lxml.etree._Element-class.html#getprevious">getprevious</a></code>,
 192       <code><a href="lxml.etree._Element-class.html#getroottree">getroottree</a></code>,
 193       <code><a href="lxml.etree._Element-class.html#index">index</a></code>,
 194       <code><a href="lxml.etree._Element-class.html#insert">insert</a></code>,
 195       <code><a href="lxml.etree._Element-class.html#items">items</a></code>,
 196       <code><a href="lxml.etree._Element-class.html#iter">iter</a></code>,
 197       <code><a href="lxml.etree._Element-class.html#iterancestors">iterancestors</a></code>,
 198       <code><a href="lxml.etree._Element-class.html#iterchildren">iterchildren</a></code>,
 199       <code><a href="lxml.etree._Element-class.html#iterdescendants">iterdescendants</a></code>,
 200       <code><a href="lxml.etree._Element-class.html#iterfind">iterfind</a></code>,
 201       <code><a href="lxml.etree._Element-class.html#itersiblings">itersiblings</a></code>,
 202       <code><a href="lxml.etree._Element-class.html#itertext">itertext</a></code>,
 203       <code><a href="lxml.etree._Element-class.html#keys">keys</a></code>,
 204       <code><a href="lxml.etree._Element-class.html#makeelement">makeelement</a></code>,
 205       <code><a href="lxml.etree._Element-class.html#remove">remove</a></code>,
 206       <code><a href="lxml.etree._Element-class.html#replace">replace</a></code>,
 207       <code><a href="lxml.etree._Element-class.html#set">set</a></code>,
 208       <code><a href="lxml.etree._Element-class.html#values">values</a></code>,
 209       <code><a href="lxml.etree._Element-class.html#xpath">xpath</a></code>
 210       </p>
 211     <div class="private">    <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a></code></b> (private):
 212       <code><a href="lxml.etree._Element-class.html#_init" onclick="show_private();">_init</a></code>
 213       </p></div>
 214     <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
 215       <code>__delattr__</code>,
 216       <code>__format__</code>,
 217       <code>__getattribute__</code>,
 218       <code>__hash__</code>,
 219       <code>__reduce__</code>,
 220       <code>__reduce_ex__</code>,
 221       <code>__setattr__</code>,
 222       <code>__sizeof__</code>,
 223       <code>__str__</code>,
 224       <code>__subclasshook__</code>
 225       </p>
 226     </td>
 227   </tr>
 228 </table>
 229 <!-- ==================== PROPERTIES ==================== -->
 230 <a name="section-Properties"></a>
 231 <table class="summary" border="1" cellpadding="3"
 232        cellspacing="0" width="100%" bgcolor="white">
 233 <tr bgcolor="#70b0f0" class="table-header">
 234   <td colspan="2" class="table-header">
 235     <table border="0" cellpadding="0" cellspacing="0" width="100%">
 236       <tr valign="top">
 237         <td align="left"><span class="table-header">Properties</span></td>
 238         <td align="right" valign="top"
 239          ><span class="options">[<a href="#section-Properties"
 240          class="privatelink" onclick="toggle_private();"
 241          >hide private</a>]</span></td>
 242       </tr>
 243     </table>
 244   </td>
 245 </tr>
 246   <tr>
 247     <td colspan="2" class="summary">
 248     <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">_Element</a></code></b>:
 249       <code><a href="lxml.etree._Element-class.html#attrib">attrib</a></code>,
 250       <code><a href="lxml.etree._Element-class.html#base">base</a></code>,
 251       <code><a href="lxml.etree._Element-class.html#nsmap">nsmap</a></code>,
 252       <code><a href="lxml.etree._Element-class.html#prefix">prefix</a></code>,
 253       <code><a href="lxml.etree._Element-class.html#sourceline">sourceline</a></code>,
 254       <code><a href="lxml.etree._Element-class.html#tag">tag</a></code>,
 255       <code><a href="lxml.etree._Element-class.html#tail">tail</a></code>,
 256       <code><a href="lxml.etree._Element-class.html#text">text</a></code>
 257       </p>
 258     <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
 259       <code>__class__</code>
 260       </p>
 261     </td>
 262   </tr>
 263 </table>
 264 <!-- ==================== METHOD DETAILS ==================== -->
 265 <a name="section-MethodDetails"></a>
 266 <table class="details" border="1" cellpadding="3"
 267        cellspacing="0" width="100%" bgcolor="white">
 268 <tr bgcolor="#70b0f0" class="table-header">
 269   <td colspan="2" class="table-header">
 270     <table border="0" cellpadding="0" cellspacing="0" width="100%">
 271       <tr valign="top">
 272         <td align="left"><span class="table-header">Method Details</span></td>
 273         <td align="right" valign="top"
 274          ><span class="options">[<a href="#section-MethodDetails"
 275          class="privatelink" onclick="toggle_private();"
 276          >hide private</a>]</span></td>
 277       </tr>
 278     </table>
 279   </td>
 280 </tr>
 281 </table>
 282 <a name="__init__"></a>
 283 <div>
 284 <table class="details" border="1" cellpadding="3"
 285        cellspacing="0" width="100%" bgcolor="white">
 286 <tr><td>
 287   <table width="100%" cellpadding="0" cellspacing="0" border="0">
 288   <tr valign="top"><td>
 289   <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">attrib</span>=<span class="sig-default">None</span>,
 290         <span class="sig-arg">nsmap</span>=<span class="sig-default">None</span>,
 291         <span class="sig-arg">*children</span>,
 292         <span class="sig-arg">**_extra</span>)</span>
 293     <br /><em class="fname">(Constructor)</em>
 294   </h3>
 295   </td><td align="right" valign="top"
 296     >&nbsp;
 297     </td>
 298   </tr></table>
 299
 300   x.__init__(...) initializes x; see help(type(x)) for signature
 301   <dl class="fields">
 302     <dt>Overrides:
 303         object.__init__
 304     </dt>
 305   </dl>
 306 </td></tr></table>
 307 </div>
 308 <a name="__new__"></a>
 309 <div>
 310 <table class="details" border="1" cellpadding="3"
 311        cellspacing="0" width="100%" bgcolor="white">
 312 <tr><td>
 313   <table width="100%" cellpadding="0" cellspacing="0" border="0">
 314   <tr valign="top"><td>
 315   <h3 class="epydoc"><span class="sig"><span class="sig-name">__new__</span>(<span class="sig-arg">T</span>,
 316         <span class="sig-arg">S</span>,
 317         <span class="sig-arg">...</span>)</span>
 318   </h3>
 319   </td><td align="right" valign="top"
 320     >&nbsp;
 321     </td>
 322   </tr></table>
 323
 324
 325   <dl class="fields">
 326     <dt>Returns: a new object with type S, a subtype of T</dt>
 327     <dt>Overrides:
 328         object.__new__
 329     </dt>
 330   </dl>
 331 </td></tr></table>
 332 </div>
 333 <br />
 334 <!-- ==================== NAVIGATION BAR ==================== -->
 335 <table class="navbar" border="0" width="100%" cellpadding="0"
 336        bgcolor="#a0c0ff" cellspacing="0">
 337   <tr valign="middle">
 338   <!-- Home link -->
 339       <th>&nbsp;&nbsp;&nbsp;<a
 340         href="lxml-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
 341
 342   <!-- Tree link -->
 343       <th>&nbsp;&nbsp;&nbsp;<a
 344         href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
 345
 346   <!-- Index link -->
 347       <th>&nbsp;&nbsp;&nbsp;<a
 348         href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
 349
 350   <!-- Help link -->
 351       <th>&nbsp;&nbsp;&nbsp;<a
 352         href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
 353
 354   <!-- Project homepage -->
 355       <th class="navbar" align="right" width="100%">
 356         <table border="0" cellpadding="0" cellspacing="0">
 357           <tr><th class="navbar" align="center"
 358             ><a class="navbar" target="_top" href="/">lxml API</a></th>
 359           </tr></table></th>
 360   </tr>
 361 </table>
 362 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
 363   <tr>
 364     <td align="left" class="footer">
 365     Generated by Epydoc 3.0.1
 366     on Wed Jan 29 12:26:21 2020
 367     </td>
 368     <td align="right" class="footer">
 369       <a target="mainFrame" href="http://epydoc.sourceforge.net"
 370         >http://epydoc.sourceforge.net</a>
 371     </td>
 372   </tr>
 373 </table>
 374
 375 <script type="text/javascript">
 376   <!--
 377   // Private objects are initially displayed (because if
 378   // javascript is turned off then we want them to be
 379   // visible); but by default, we want to hide them.  So hide
 380   // them unless we have a cookie that says to show them.
 381   checkCookie();
 382   // -->
 383 </script>
 384 </body>
 385 </html>