1ed35b8e0eaaae4dec6b95161fb4709217be50d5
[platform/upstream/python-lxml.git] / doc / html / api / lxml.objectify.ObjectifiedElement-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.objectify.ObjectifiedElement</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.objectify-module.html">Module&nbsp;objectify</a> ::
47         Class&nbsp;ObjectifiedElement
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.objectify.ObjectifiedElement-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 ObjectifiedElement</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();">etree._Element</a> --+    
69                  |    
70  <a href="lxml.etree.ElementBase-class.html">etree.ElementBase</a> --+
71                      |
72                     <strong class="uidshort">ObjectifiedElement</strong>
73 </pre>
74
75 <dl><dt>Known Subclasses:</dt>
76 <dd>
77       <ul class="subclass-list">
78 <li><a href="lxml.objectify.ObjectifiedDataElement-class.html">ObjectifiedDataElement</a></li>  </ul>
79 </dd></dl>
80
81 <hr />
82 <p>Main XML Element class.</p>
83 <p>Element children are accessed as object attributes.  Multiple children
84 with the same name are available through a list index.  Example:</p>
85 <pre class="rst-literal-block">
86 &gt;&gt;&gt; root = XML(&quot;&lt;root&gt;&lt;c1&gt;&lt;c2&gt;0&lt;/c2&gt;&lt;c2&gt;1&lt;/c2&gt;&lt;/c1&gt;&lt;/root&gt;&quot;)
87 &gt;&gt;&gt; second_c2 = root.c1.c2[1]
88 &gt;&gt;&gt; print(second_c2.text)
89 1
90 </pre>
91 <p>Note that you cannot (and must not) instantiate this class or its
92 subclasses.</p>
93
94 <!-- ==================== INSTANCE METHODS ==================== -->
95 <a name="section-InstanceMethods"></a>
96 <table class="summary" border="1" cellpadding="3"
97        cellspacing="0" width="100%" bgcolor="white">
98 <tr bgcolor="#70b0f0" class="table-header">
99   <td colspan="2" class="table-header">
100     <table border="0" cellpadding="0" cellspacing="0" width="100%">
101       <tr valign="top">
102         <td align="left"><span class="table-header">Instance Methods</span></td>
103         <td align="right" valign="top"
104          ><span class="options">[<a href="#section-InstanceMethods"
105          class="privatelink" onclick="toggle_private();"
106          >hide private</a>]</span></td>
107       </tr>
108     </table>
109   </td>
110 </tr>
111 <tr>
112     <td width="15%" align="right" valign="top" class="summary">
113       <span class="summary-type">&nbsp;</span>
114     </td><td class="summary">
115       <table width="100%" cellpadding="0" cellspacing="0" border="0">
116         <tr>
117           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__delattr__" class="summary-sig-name">__delattr__</a>(<span class="summary-sig-arg">...</span>)</span><br />
118       x.__delattr__('name') &lt;==&gt; del x.name</td>
119           <td align="right" valign="top">
120             
121             
122           </td>
123         </tr>
124       </table>
125       
126     </td>
127   </tr>
128 <tr>
129     <td width="15%" align="right" valign="top" class="summary">
130       <span class="summary-type">&nbsp;</span>
131     </td><td class="summary">
132       <table width="100%" cellpadding="0" cellspacing="0" border="0">
133         <tr>
134           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__delitem__" class="summary-sig-name">__delitem__</a>(<span class="summary-sig-arg">x</span>,
135         <span class="summary-sig-arg">y</span>)</span><br />
136       del x[y]</td>
137           <td align="right" valign="top">
138             
139             
140           </td>
141         </tr>
142       </table>
143       
144     </td>
145   </tr>
146 <tr>
147     <td width="15%" align="right" valign="top" class="summary">
148       <span class="summary-type">&nbsp;</span>
149     </td><td class="summary">
150       <table width="100%" cellpadding="0" cellspacing="0" border="0">
151         <tr>
152           <td><span class="summary-sig"><a name="__getattr__"></a><span class="summary-sig-name">__getattr__</span>(<span class="summary-sig-arg">...</span>)</span><br />
153       Return the (first) child with the given tag name.  If no namespace
154 is provided, the child will be looked up in the same one as self.</td>
155           <td align="right" valign="top">
156             
157             
158           </td>
159         </tr>
160       </table>
161       
162     </td>
163   </tr>
164 <tr>
165     <td width="15%" align="right" valign="top" class="summary">
166       <span class="summary-type">&nbsp;</span>
167     </td><td class="summary">
168       <table width="100%" cellpadding="0" cellspacing="0" border="0">
169         <tr>
170           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__getattribute__" class="summary-sig-name">__getattribute__</a>(<span class="summary-sig-arg">...</span>)</span><br />
171       x.__getattribute__('name') &lt;==&gt; x.name</td>
172           <td align="right" valign="top">
173             
174             
175           </td>
176         </tr>
177       </table>
178       
179     </td>
180   </tr>
181 <tr>
182     <td width="15%" align="right" valign="top" class="summary">
183       <span class="summary-type">&nbsp;</span>
184     </td><td class="summary">
185       <table width="100%" cellpadding="0" cellspacing="0" border="0">
186         <tr>
187           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__getitem__" class="summary-sig-name">__getitem__</a>(<span class="summary-sig-arg">...</span>)</span><br />
188       Return a sibling, counting from the first child of the parent.  The
189 method behaves like both a dict and a sequence.</td>
190           <td align="right" valign="top">
191             
192             
193           </td>
194         </tr>
195       </table>
196       
197     </td>
198   </tr>
199 <tr>
200     <td width="15%" align="right" valign="top" class="summary">
201       <span class="summary-type">&nbsp;</span>
202     </td><td class="summary">
203       <table width="100%" cellpadding="0" cellspacing="0" border="0">
204         <tr>
205           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__iter__" class="summary-sig-name">__iter__</a>(<span class="summary-sig-arg">...</span>)</span><br />
206       Iterate over self and all siblings with the same tag.</td>
207           <td align="right" valign="top">
208             
209             
210           </td>
211         </tr>
212       </table>
213       
214     </td>
215   </tr>
216 <tr>
217     <td width="15%" align="right" valign="top" class="summary">
218       <span class="summary-type">&nbsp;</span>
219     </td><td class="summary">
220       <table width="100%" cellpadding="0" cellspacing="0" border="0">
221         <tr>
222           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__len__" class="summary-sig-name">__len__</a>(<span class="summary-sig-arg">...</span>)</span><br />
223       Count self and siblings with the same tag.</td>
224           <td align="right" valign="top">
225             
226             
227           </td>
228         </tr>
229       </table>
230       
231     </td>
232   </tr>
233 <tr>
234     <td width="15%" align="right" valign="top" class="summary">
235       <span class="summary-type">a new object with type S, a subtype of T</span>
236     </td><td class="summary">
237       <table width="100%" cellpadding="0" cellspacing="0" border="0">
238         <tr>
239           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__new__" class="summary-sig-name">__new__</a>(<span class="summary-sig-arg">T</span>,
240         <span class="summary-sig-arg">S</span>,
241         <span class="summary-sig-arg">...</span>)</span></td>
242           <td align="right" valign="top">
243             
244             
245           </td>
246         </tr>
247       </table>
248       
249     </td>
250   </tr>
251 <tr>
252     <td width="15%" align="right" valign="top" class="summary">
253       <span class="summary-type">&nbsp;</span>
254     </td><td class="summary">
255       <table width="100%" cellpadding="0" cellspacing="0" border="0">
256         <tr>
257           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__reduce__" class="summary-sig-name">__reduce__</a>(<span class="summary-sig-arg">...</span>)</span><br />
258       helper for pickle</td>
259           <td align="right" valign="top">
260             
261             
262           </td>
263         </tr>
264       </table>
265       
266     </td>
267   </tr>
268 <tr>
269     <td width="15%" align="right" valign="top" class="summary">
270       <span class="summary-type">&nbsp;</span>
271     </td><td class="summary">
272       <table width="100%" cellpadding="0" cellspacing="0" border="0">
273         <tr>
274           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__setattr__" class="summary-sig-name">__setattr__</a>(<span class="summary-sig-arg">...</span>)</span><br />
275       Set the value of the (first) child with the given tag name.  If no
276 namespace is provided, the child will be looked up in the same one as
277 self.</td>
278           <td align="right" valign="top">
279             
280             
281           </td>
282         </tr>
283       </table>
284       
285     </td>
286   </tr>
287 <tr>
288     <td width="15%" align="right" valign="top" class="summary">
289       <span class="summary-type">&nbsp;</span>
290     </td><td class="summary">
291       <table width="100%" cellpadding="0" cellspacing="0" border="0">
292         <tr>
293           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__setitem__" class="summary-sig-name">__setitem__</a>(<span class="summary-sig-arg">...</span>)</span><br />
294       Set the value of a sibling, counting from the first child of the
295 parent.  Implements key assignment, item assignment and slice
296 assignment.</td>
297           <td align="right" valign="top">
298             
299             
300           </td>
301         </tr>
302       </table>
303       
304     </td>
305   </tr>
306 <tr>
307     <td width="15%" align="right" valign="top" class="summary">
308       <span class="summary-type">&nbsp;</span>
309     </td><td class="summary">
310       <table width="100%" cellpadding="0" cellspacing="0" border="0">
311         <tr>
312           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">x</span>)</span><br />
313       str(x)</td>
314           <td align="right" valign="top">
315             
316             
317           </td>
318         </tr>
319       </table>
320       
321     </td>
322   </tr>
323 <tr>
324     <td width="15%" align="right" valign="top" class="summary">
325       <span class="summary-type">&nbsp;</span>
326     </td><td class="summary">
327       <table width="100%" cellpadding="0" cellspacing="0" border="0">
328         <tr>
329           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#addattr" class="summary-sig-name">addattr</a>(<span class="summary-sig-arg">self</span>,
330         <span class="summary-sig-arg">tag</span>,
331         <span class="summary-sig-arg">value</span>)</span><br />
332       Add a child value to the element.</td>
333           <td align="right" valign="top">
334             
335             
336           </td>
337         </tr>
338       </table>
339       
340     </td>
341   </tr>
342 <tr>
343     <td width="15%" align="right" valign="top" class="summary">
344       <span class="summary-type">&nbsp;</span>
345     </td><td class="summary">
346       <table width="100%" cellpadding="0" cellspacing="0" border="0">
347         <tr>
348           <td><span class="summary-sig"><a name="countchildren"></a><span class="summary-sig-name">countchildren</span>(<span class="summary-sig-arg">self</span>)</span><br />
349       Return the number of children of this element, regardless of their
350 name.</td>
351           <td align="right" valign="top">
352             
353             
354           </td>
355         </tr>
356       </table>
357       
358     </td>
359   </tr>
360 <tr>
361     <td width="15%" align="right" valign="top" class="summary">
362       <span class="summary-type">&nbsp;</span>
363     </td><td class="summary">
364       <table width="100%" cellpadding="0" cellspacing="0" border="0">
365         <tr>
366           <td><span class="summary-sig"><a name="descendantpaths"></a><span class="summary-sig-name">descendantpaths</span>(<span class="summary-sig-arg">self</span>,
367         <span class="summary-sig-arg">prefix</span>=<span class="summary-sig-default">None</span>)</span><br />
368       Returns a list of object path expressions for all descendants.</td>
369           <td align="right" valign="top">
370             
371             
372           </td>
373         </tr>
374       </table>
375       
376     </td>
377   </tr>
378 <tr>
379     <td width="15%" align="right" valign="top" class="summary">
380       <span class="summary-type">&nbsp;</span>
381     </td><td class="summary">
382       <table width="100%" cellpadding="0" cellspacing="0" border="0">
383         <tr>
384           <td><span class="summary-sig"><a href="lxml.objectify.ObjectifiedElement-class.html#getchildren" class="summary-sig-name">getchildren</a>(<span class="summary-sig-arg">self</span>)</span><br />
385       Returns a sequence of all direct children.  The elements are
386 returned in document order.</td>
387           <td align="right" valign="top">
388             
389             
390           </td>
391         </tr>
392       </table>
393       
394     </td>
395   </tr>
396   <tr>
397     <td colspan="2" class="summary">
398     <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree.ElementBase-class.html">etree.ElementBase</a></code></b>:
399       <code><a href="lxml.etree.ElementBase-class.html#__init__">__init__</a></code>
400       </p>
401     <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">etree._Element</a></code></b>:
402       <code><a href="lxml.etree._Element-class.html#__contains__">__contains__</a></code>,
403       <code><a href="lxml.etree._Element-class.html#__copy__">__copy__</a></code>,
404       <code><a href="lxml.etree._Element-class.html#__deepcopy__">__deepcopy__</a></code>,
405       <code><a href="lxml.etree._Element-class.html#__nonzero__">__nonzero__</a></code>,
406       <code><a href="lxml.etree._Element-class.html#__repr__">__repr__</a></code>,
407       <code><a href="lxml.etree._Element-class.html#__reversed__">__reversed__</a></code>,
408       <code><a href="lxml.etree._Element-class.html#addnext">addnext</a></code>,
409       <code><a href="lxml.etree._Element-class.html#addprevious">addprevious</a></code>,
410       <code><a href="lxml.etree._Element-class.html#append">append</a></code>,
411       <code><a href="lxml.etree._Element-class.html#clear">clear</a></code>,
412       <code><a href="lxml.etree._Element-class.html#cssselect">cssselect</a></code>,
413       <code><a href="lxml.etree._Element-class.html#extend">extend</a></code>,
414       <code><a href="lxml.etree._Element-class.html#find">find</a></code>,
415       <code><a href="lxml.etree._Element-class.html#findall">findall</a></code>,
416       <code><a href="lxml.etree._Element-class.html#findtext">findtext</a></code>,
417       <code><a href="lxml.etree._Element-class.html#get">get</a></code>,
418       <code><a href="lxml.etree._Element-class.html#getiterator">getiterator</a></code>,
419       <code><a href="lxml.etree._Element-class.html#getnext">getnext</a></code>,
420       <code><a href="lxml.etree._Element-class.html#getparent">getparent</a></code>,
421       <code><a href="lxml.etree._Element-class.html#getprevious">getprevious</a></code>,
422       <code><a href="lxml.etree._Element-class.html#getroottree">getroottree</a></code>,
423       <code><a href="lxml.etree._Element-class.html#index">index</a></code>,
424       <code><a href="lxml.etree._Element-class.html#insert">insert</a></code>,
425       <code><a href="lxml.etree._Element-class.html#items">items</a></code>,
426       <code><a href="lxml.etree._Element-class.html#iter">iter</a></code>,
427       <code><a href="lxml.etree._Element-class.html#iterancestors">iterancestors</a></code>,
428       <code><a href="lxml.etree._Element-class.html#iterchildren">iterchildren</a></code>,
429       <code><a href="lxml.etree._Element-class.html#iterdescendants">iterdescendants</a></code>,
430       <code><a href="lxml.etree._Element-class.html#iterfind">iterfind</a></code>,
431       <code><a href="lxml.etree._Element-class.html#itersiblings">itersiblings</a></code>,
432       <code><a href="lxml.etree._Element-class.html#itertext">itertext</a></code>,
433       <code><a href="lxml.etree._Element-class.html#keys">keys</a></code>,
434       <code><a href="lxml.etree._Element-class.html#makeelement">makeelement</a></code>,
435       <code><a href="lxml.etree._Element-class.html#remove">remove</a></code>,
436       <code><a href="lxml.etree._Element-class.html#replace">replace</a></code>,
437       <code><a href="lxml.etree._Element-class.html#set">set</a></code>,
438       <code><a href="lxml.etree._Element-class.html#values">values</a></code>,
439       <code><a href="lxml.etree._Element-class.html#xpath">xpath</a></code>
440       </p>
441     <div class="private">    <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">etree._Element</a></code></b> (private):
442       <code><a href="lxml.etree._Element-class.html#_init" onclick="show_private();">_init</a></code>
443       </p></div>
444     <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
445       <code>__format__</code>,
446       <code>__hash__</code>,
447       <code>__reduce_ex__</code>,
448       <code>__sizeof__</code>,
449       <code>__subclasshook__</code>
450       </p>
451     </td>
452   </tr>
453 </table>
454 <!-- ==================== PROPERTIES ==================== -->
455 <a name="section-Properties"></a>
456 <table class="summary" border="1" cellpadding="3"
457        cellspacing="0" width="100%" bgcolor="white">
458 <tr bgcolor="#70b0f0" class="table-header">
459   <td colspan="2" class="table-header">
460     <table border="0" cellpadding="0" cellspacing="0" width="100%">
461       <tr valign="top">
462         <td align="left"><span class="table-header">Properties</span></td>
463         <td align="right" valign="top"
464          ><span class="options">[<a href="#section-Properties"
465          class="privatelink" onclick="toggle_private();"
466          >hide private</a>]</span></td>
467       </tr>
468     </table>
469   </td>
470 </tr>
471 <tr>
472     <td width="15%" align="right" valign="top" class="summary">
473       <span class="summary-type">&nbsp;</span>
474     </td><td class="summary">
475         <a name="text"></a><span class="summary-name">text</span><br />
476       Text before the first subelement. This is either a string or
477 the value None, if there was no text.
478     </td>
479   </tr>
480   <tr>
481     <td colspan="2" class="summary">
482     <p class="indent-wrapped-lines"><b>Inherited from <code><a href="lxml.etree._Element-class.html" onclick="show_private();">etree._Element</a></code></b>:
483       <code><a href="lxml.etree._Element-class.html#attrib">attrib</a></code>,
484       <code><a href="lxml.etree._Element-class.html#base">base</a></code>,
485       <code><a href="lxml.etree._Element-class.html#nsmap">nsmap</a></code>,
486       <code><a href="lxml.etree._Element-class.html#prefix">prefix</a></code>,
487       <code><a href="lxml.etree._Element-class.html#sourceline">sourceline</a></code>,
488       <code><a href="lxml.etree._Element-class.html#tag">tag</a></code>,
489       <code><a href="lxml.etree._Element-class.html#tail">tail</a></code>
490       </p>
491     <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>:
492       <code>__class__</code>
493       </p>
494     </td>
495   </tr>
496 </table>
497 <!-- ==================== METHOD DETAILS ==================== -->
498 <a name="section-MethodDetails"></a>
499 <table class="details" border="1" cellpadding="3"
500        cellspacing="0" width="100%" bgcolor="white">
501 <tr bgcolor="#70b0f0" class="table-header">
502   <td colspan="2" class="table-header">
503     <table border="0" cellpadding="0" cellspacing="0" width="100%">
504       <tr valign="top">
505         <td align="left"><span class="table-header">Method Details</span></td>
506         <td align="right" valign="top"
507          ><span class="options">[<a href="#section-MethodDetails"
508          class="privatelink" onclick="toggle_private();"
509          >hide private</a>]</span></td>
510       </tr>
511     </table>
512   </td>
513 </tr>
514 </table>
515 <a name="__delattr__"></a>
516 <div>
517 <table class="details" border="1" cellpadding="3"
518        cellspacing="0" width="100%" bgcolor="white">
519 <tr><td>
520   <table width="100%" cellpadding="0" cellspacing="0" border="0">
521   <tr valign="top"><td>
522   <h3 class="epydoc"><span class="sig"><span class="sig-name">__delattr__</span>(<span class="sig-arg">...</span>)</span>
523   </h3>
524   </td><td align="right" valign="top"
525     >&nbsp;
526     </td>
527   </tr></table>
528   
529   x.__delattr__('name') &lt;==&gt; del x.name
530   <dl class="fields">
531     <dt>Overrides:
532         object.__delattr__
533     </dt>
534   </dl>
535 </td></tr></table>
536 </div>
537 <a name="__delitem__"></a>
538 <div>
539 <table class="details" border="1" cellpadding="3"
540        cellspacing="0" width="100%" bgcolor="white">
541 <tr><td>
542   <table width="100%" cellpadding="0" cellspacing="0" border="0">
543   <tr valign="top"><td>
544   <h3 class="epydoc"><span class="sig"><span class="sig-name">__delitem__</span>(<span class="sig-arg">x</span>,
545         <span class="sig-arg">y</span>)</span>
546     <br /><em class="fname">(Index deletion operator)</em>
547   </h3>
548   </td><td align="right" valign="top"
549     >&nbsp;
550     </td>
551   </tr></table>
552   
553   del x[y]
554   <dl class="fields">
555     <dt>Overrides:
556         <a href="lxml.etree._Element-class.html#__delitem__">etree._Element.__delitem__</a>
557     </dt>
558   </dl>
559 </td></tr></table>
560 </div>
561 <a name="__getattribute__"></a>
562 <div>
563 <table class="details" border="1" cellpadding="3"
564        cellspacing="0" width="100%" bgcolor="white">
565 <tr><td>
566   <table width="100%" cellpadding="0" cellspacing="0" border="0">
567   <tr valign="top"><td>
568   <h3 class="epydoc"><span class="sig"><span class="sig-name">__getattribute__</span>(<span class="sig-arg">...</span>)</span>
569   </h3>
570   </td><td align="right" valign="top"
571     >&nbsp;
572     </td>
573   </tr></table>
574   
575   x.__getattribute__('name') &lt;==&gt; x.name
576   <dl class="fields">
577     <dt>Overrides:
578         object.__getattribute__
579     </dt>
580   </dl>
581 </td></tr></table>
582 </div>
583 <a name="__getitem__"></a>
584 <div>
585 <table class="details" border="1" cellpadding="3"
586        cellspacing="0" width="100%" bgcolor="white">
587 <tr><td>
588   <table width="100%" cellpadding="0" cellspacing="0" border="0">
589   <tr valign="top"><td>
590   <h3 class="epydoc"><span class="sig"><span class="sig-name">__getitem__</span>(<span class="sig-arg">...</span>)</span>
591     <br /><em class="fname">(Indexing operator)</em>
592   </h3>
593   </td><td align="right" valign="top"
594     >&nbsp;
595     </td>
596   </tr></table>
597   
598   <p>Return a sibling, counting from the first child of the parent.  The
599 method behaves like both a dict and a sequence.</p>
600 <ul class="rst-simple">
601 <li>If argument is an integer, returns the sibling at that position.</li>
602 <li>If argument is a string, does the same as getattr().  This can be
603 used to provide namespaces for element lookup, or to look up
604 children with special names (<tt class="rst-docutils literal">text</tt> etc.).</li>
605 <li>If argument is a slice object, returns the matching slice.</li>
606 </ul>
607   <dl class="fields">
608     <dt>Overrides:
609         <a href="lxml.etree._Element-class.html#__getitem__">etree._Element.__getitem__</a>
610     </dt>
611   </dl>
612 </td></tr></table>
613 </div>
614 <a name="__iter__"></a>
615 <div>
616 <table class="details" border="1" cellpadding="3"
617        cellspacing="0" width="100%" bgcolor="white">
618 <tr><td>
619   <table width="100%" cellpadding="0" cellspacing="0" border="0">
620   <tr valign="top"><td>
621   <h3 class="epydoc"><span class="sig"><span class="sig-name">__iter__</span>(<span class="sig-arg">...</span>)</span>
622   </h3>
623   </td><td align="right" valign="top"
624     >&nbsp;
625     </td>
626   </tr></table>
627   
628   Iterate over self and all siblings with the same tag.
629   <dl class="fields">
630     <dt>Overrides:
631         <a href="lxml.etree._Element-class.html#__iter__">etree._Element.__iter__</a>
632     </dt>
633   </dl>
634 </td></tr></table>
635 </div>
636 <a name="__len__"></a>
637 <div>
638 <table class="details" border="1" cellpadding="3"
639        cellspacing="0" width="100%" bgcolor="white">
640 <tr><td>
641   <table width="100%" cellpadding="0" cellspacing="0" border="0">
642   <tr valign="top"><td>
643   <h3 class="epydoc"><span class="sig"><span class="sig-name">__len__</span>(<span class="sig-arg">...</span>)</span>
644     <br /><em class="fname">(Length operator)</em>
645   </h3>
646   </td><td align="right" valign="top"
647     >&nbsp;
648     </td>
649   </tr></table>
650   
651   Count self and siblings with the same tag.
652   <dl class="fields">
653     <dt>Overrides:
654         <a href="lxml.etree._Element-class.html#__len__">etree._Element.__len__</a>
655     </dt>
656   </dl>
657 </td></tr></table>
658 </div>
659 <a name="__new__"></a>
660 <div>
661 <table class="details" border="1" cellpadding="3"
662        cellspacing="0" width="100%" bgcolor="white">
663 <tr><td>
664   <table width="100%" cellpadding="0" cellspacing="0" border="0">
665   <tr valign="top"><td>
666   <h3 class="epydoc"><span class="sig"><span class="sig-name">__new__</span>(<span class="sig-arg">T</span>,
667         <span class="sig-arg">S</span>,
668         <span class="sig-arg">...</span>)</span>
669   </h3>
670   </td><td align="right" valign="top"
671     >&nbsp;
672     </td>
673   </tr></table>
674   
675   
676   <dl class="fields">
677     <dt>Returns: a new object with type S, a subtype of T</dt>
678     <dt>Overrides:
679         object.__new__
680     </dt>
681   </dl>
682 </td></tr></table>
683 </div>
684 <a name="__reduce__"></a>
685 <div>
686 <table class="details" border="1" cellpadding="3"
687        cellspacing="0" width="100%" bgcolor="white">
688 <tr><td>
689   <table width="100%" cellpadding="0" cellspacing="0" border="0">
690   <tr valign="top"><td>
691   <h3 class="epydoc"><span class="sig"><span class="sig-name">__reduce__</span>(<span class="sig-arg">...</span>)</span>
692   </h3>
693   </td><td align="right" valign="top"
694     >&nbsp;
695     </td>
696   </tr></table>
697   
698   helper for pickle
699   <dl class="fields">
700     <dt>Overrides:
701         object.__reduce__
702         <dd><em class="note">(inherited documentation)</em></dd>
703     </dt>
704   </dl>
705 </td></tr></table>
706 </div>
707 <a name="__setattr__"></a>
708 <div>
709 <table class="details" border="1" cellpadding="3"
710        cellspacing="0" width="100%" bgcolor="white">
711 <tr><td>
712   <table width="100%" cellpadding="0" cellspacing="0" border="0">
713   <tr valign="top"><td>
714   <h3 class="epydoc"><span class="sig"><span class="sig-name">__setattr__</span>(<span class="sig-arg">...</span>)</span>
715   </h3>
716   </td><td align="right" valign="top"
717     >&nbsp;
718     </td>
719   </tr></table>
720   
721   Set the value of the (first) child with the given tag name.  If no
722 namespace is provided, the child will be looked up in the same one as
723 self.
724   <dl class="fields">
725     <dt>Overrides:
726         object.__setattr__
727     </dt>
728   </dl>
729 </td></tr></table>
730 </div>
731 <a name="__setitem__"></a>
732 <div>
733 <table class="details" border="1" cellpadding="3"
734        cellspacing="0" width="100%" bgcolor="white">
735 <tr><td>
736   <table width="100%" cellpadding="0" cellspacing="0" border="0">
737   <tr valign="top"><td>
738   <h3 class="epydoc"><span class="sig"><span class="sig-name">__setitem__</span>(<span class="sig-arg">...</span>)</span>
739     <br /><em class="fname">(Index assignment operator)</em>
740   </h3>
741   </td><td align="right" valign="top"
742     >&nbsp;
743     </td>
744   </tr></table>
745   
746   <p>Set the value of a sibling, counting from the first child of the
747 parent.  Implements key assignment, item assignment and slice
748 assignment.</p>
749 <ul class="rst-simple">
750 <li>If argument is an integer, sets the sibling at that position.</li>
751 <li>If argument is a string, does the same as setattr().  This is used
752 to provide namespaces for element lookup.</li>
753 <li>If argument is a sequence (list, tuple, etc.), assign the contained
754 items to the siblings.</li>
755 </ul>
756   <dl class="fields">
757     <dt>Overrides:
758         <a href="lxml.etree._Element-class.html#__setitem__">etree._Element.__setitem__</a>
759     </dt>
760   </dl>
761 </td></tr></table>
762 </div>
763 <a name="__str__"></a>
764 <div>
765 <table class="details" border="1" cellpadding="3"
766        cellspacing="0" width="100%" bgcolor="white">
767 <tr><td>
768   <table width="100%" cellpadding="0" cellspacing="0" border="0">
769   <tr valign="top"><td>
770   <h3 class="epydoc"><span class="sig"><span class="sig-name">__str__</span>(<span class="sig-arg">x</span>)</span>
771     <br /><em class="fname">(Informal representation operator)</em>
772   </h3>
773   </td><td align="right" valign="top"
774     >&nbsp;
775     </td>
776   </tr></table>
777   
778   str(x)
779   <dl class="fields">
780     <dt>Overrides:
781         object.__str__
782     </dt>
783   </dl>
784 </td></tr></table>
785 </div>
786 <a name="addattr"></a>
787 <div>
788 <table class="details" border="1" cellpadding="3"
789        cellspacing="0" width="100%" bgcolor="white">
790 <tr><td>
791   <table width="100%" cellpadding="0" cellspacing="0" border="0">
792   <tr valign="top"><td>
793   <h3 class="epydoc"><span class="sig"><span class="sig-name">addattr</span>(<span class="sig-arg">self</span>,
794         <span class="sig-arg">tag</span>,
795         <span class="sig-arg">value</span>)</span>
796   </h3>
797   </td><td align="right" valign="top"
798     >&nbsp;
799     </td>
800   </tr></table>
801   
802   <p>Add a child value to the element.</p>
803 <p>As opposed to append(), it sets a data value, not an element.</p>
804   <dl class="fields">
805   </dl>
806 </td></tr></table>
807 </div>
808 <a name="getchildren"></a>
809 <div>
810 <table class="details" border="1" cellpadding="3"
811        cellspacing="0" width="100%" bgcolor="white">
812 <tr><td>
813   <table width="100%" cellpadding="0" cellspacing="0" border="0">
814   <tr valign="top"><td>
815   <h3 class="epydoc"><span class="sig"><span class="sig-name">getchildren</span>(<span class="sig-arg">self</span>)</span>
816   </h3>
817   </td><td align="right" valign="top"
818     >&nbsp;
819     </td>
820   </tr></table>
821   
822   Returns a sequence of all direct children.  The elements are
823 returned in document order.
824   <dl class="fields">
825     <dt>Overrides:
826         <a href="lxml.etree._Element-class.html#getchildren">etree._Element.getchildren</a>
827     </dt>
828   </dl>
829 </td></tr></table>
830 </div>
831 <br />
832 <!-- ==================== NAVIGATION BAR ==================== -->
833 <table class="navbar" border="0" width="100%" cellpadding="0"
834        bgcolor="#a0c0ff" cellspacing="0">
835   <tr valign="middle">
836   <!-- Home link -->
837       <th>&nbsp;&nbsp;&nbsp;<a
838         href="lxml-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
839
840   <!-- Tree link -->
841       <th>&nbsp;&nbsp;&nbsp;<a
842         href="module-tree.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
843
844   <!-- Index link -->
845       <th>&nbsp;&nbsp;&nbsp;<a
846         href="identifier-index.html">Indices</a>&nbsp;&nbsp;&nbsp;</th>
847
848   <!-- Help link -->
849       <th>&nbsp;&nbsp;&nbsp;<a
850         href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
851
852   <!-- Project homepage -->
853       <th class="navbar" align="right" width="100%">
854         <table border="0" cellpadding="0" cellspacing="0">
855           <tr><th class="navbar" align="center"
856             ><a class="navbar" target="_top" href="/">lxml API</a></th>
857           </tr></table></th>
858   </tr>
859 </table>
860 <table border="0" cellpadding="0" cellspacing="0" width="100%%">
861   <tr>
862     <td align="left" class="footer">
863     Generated by Epydoc 3.0.1
864     on Wed Jan 29 12:26:21 2020
865     </td>
866     <td align="right" class="footer">
867       <a target="mainFrame" href="http://epydoc.sourceforge.net"
868         >http://epydoc.sourceforge.net</a>
869     </td>
870   </tr>
871 </table>
872
873 <script type="text/javascript">
874   <!--
875   // Private objects are initially displayed (because if
876   // javascript is turned off then we want them to be
877   // visible); but by default, we want to hide them.  So hide
878   // them unless we have a cookie that says to show them.
879   checkCookie();
880   // -->
881 </script>
882 </body>
883 </html>