Annotation of embedaddon/libxml2/doc/devhelp/libxml2-list.html, revision 1.1.1.1

1.1       misho       1: <?xml version="1.0" encoding="UTF-8"?>
                      2: <html>
                      3:   <head>
                      4:     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
                      5:     <title>list: lists interfaces</title>
                      6:     <meta name="generator" content="Libxml2 devhelp stylesheet"/>
                      7:     <link rel="start" href="index.html" title="libxml2 Reference Manual"/>
                      8:     <link rel="up" href="general.html" title="API"/>
                      9:     <link rel="stylesheet" href="style.css" type="text/css"/>
                     10:     <link rel="chapter" href="general.html" title="API"/>
                     11:   </head>
                     12:   <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
                     13:     <table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
                     14:       <tr valign="middle">
                     15:         <td>
                     16:           <a accesskey="p" href="libxml2-hash.html">
                     17:             <img src="left.png" width="24" height="24" border="0" alt="Prev"/>
                     18:           </a>
                     19:         </td>
                     20:         <td>
                     21:           <a accesskey="u" href="general.html">
                     22:             <img src="up.png" width="24" height="24" border="0" alt="Up"/>
                     23:           </a>
                     24:         </td>
                     25:         <td>
                     26:           <a accesskey="h" href="index.html">
                     27:             <img src="home.png" width="24" height="24" border="0" alt="Home"/>
                     28:           </a>
                     29:         </td>
                     30:         <td>
                     31:           <a accesskey="n" href="libxml2-nanoftp.html">
                     32:             <img src="right.png" width="24" height="24" border="0" alt="Next"/>
                     33:           </a>
                     34:         </td>
                     35:         <th width="100%" align="center">libxml2 Reference Manual</th>
                     36:       </tr>
                     37:     </table>
                     38:     <h2>
                     39:       <span class="refentrytitle">list</span>
                     40:     </h2>
                     41:     <p>list - lists interfaces</p>
                     42:     <p>this module implement the list support used in various place in the library. </p>
                     43:     <p>Author(s): Gary Pennington &lt;Gary.Pennington@uk.sun.com&gt; </p>
                     44:     <div class="refsynopsisdiv">
                     45:       <h2>Synopsis</h2>
                     46:       <pre class="synopsis">typedef struct _xmlLink <a href="#xmlLink">xmlLink</a>;
                     47: typedef <a href="libxml2-list.html#xmlLink">xmlLink</a> * <a href="#xmlLinkPtr">xmlLinkPtr</a>;
                     48: typedef struct _xmlList <a href="#xmlList">xmlList</a>;
                     49: typedef <a href="libxml2-list.html#xmlList">xmlList</a> * <a href="#xmlListPtr">xmlListPtr</a>;
                     50: int    <a href="#xmlListInsert">xmlListInsert</a>                      (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     51: int    <a href="#xmlListEmpty">xmlListEmpty</a>                        (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     52: void   <a href="#xmlListSort">xmlListSort</a>                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     53: typedef void <a href="#xmlListDeallocator">xmlListDeallocator</a>              (<a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a> lk);
                     54: void   <a href="#xmlListMerge">xmlListMerge</a>                        (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l1, <br/>                                         <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l2);
                     55: <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a>  <a href="#xmlListCreate">xmlListCreate</a>              (<a href="libxml2-list.html#xmlListDeallocator">xmlListDeallocator</a> deallocator, <br/>                                        <a href="libxml2-list.html#xmlListDataCompare">xmlListDataCompare</a> compare);
                     56: <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a>  <a href="#xmlListDup">xmlListDup</a>            (const <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> old);
                     57: int    <a href="#xmlListRemoveLast">xmlListRemoveLast</a>              (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     58: void   <a href="#xmlListWalk">xmlListWalk</a>                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  <a href="libxml2-list.html#xmlListWalker">xmlListWalker</a> walker, <br/>                                       const void * user);
                     59: int    <a href="#xmlListRemoveAll">xmlListRemoveAll</a>                (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     60: int    <a href="#xmlListCopy">xmlListCopy</a>                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> cur, <br/>                                        const <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> old);
                     61: void   <a href="#xmlListPopFront">xmlListPopFront</a>                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     62: void * <a href="#xmlListSearch">xmlListSearch</a>                      (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     63: typedef int <a href="#xmlListWalker">xmlListWalker</a>                 (const void * data, <br/>                                        const void * user);
                     64: int    <a href="#xmlListRemoveFirst">xmlListRemoveFirst</a>            (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     65: void   <a href="#xmlListReverseWalk">xmlListReverseWalk</a>            (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  <a href="libxml2-list.html#xmlListWalker">xmlListWalker</a> walker, <br/>                                       const void * user);
                     66: void * <a href="#xmlLinkGetData">xmlLinkGetData</a>                    (<a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a> lk);
                     67: void   <a href="#xmlListClear">xmlListClear</a>                        (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     68: int    <a href="#xmlListAppend">xmlListAppend</a>                      (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     69: void   <a href="#xmlListReverse">xmlListReverse</a>                    (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     70: typedef int <a href="#xmlListDataCompare">xmlListDataCompare</a>               (const void * data0, <br/>                                       const void * data1);
                     71: int    <a href="#xmlListSize">xmlListSize</a>                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     72: int    <a href="#xmlListPushFront">xmlListPushFront</a>                (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     73: <a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a>  <a href="#xmlListEnd">xmlListEnd</a>            (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     74: void   <a href="#xmlListPopBack">xmlListPopBack</a>                    (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     75: void * <a href="#xmlListReverseSearch">xmlListReverseSearch</a>                (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     76: int    <a href="#xmlListPushBack">xmlListPushBack</a>                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data);
                     77: <a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a>  <a href="#xmlListFront">xmlListFront</a>                (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     78: void   <a href="#xmlListDelete">xmlListDelete</a>                      (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l);
                     79: </pre>
                     80:     </div>
                     81:     <div class="refsect1" lang="en">
                     82:       <h2>Description</h2>
                     83:     </div>
                     84:     <div class="refsect1" lang="en">
                     85:       <h2>Details</h2>
                     86:       <div class="refsect2" lang="en">
                     87:         <div class="refsect2" lang="en"><h3><a name="xmlLink">Structure </a>xmlLink</h3><pre class="programlisting">struct _xmlLink {
                     88: The content of this structure is not made public by the API.
                     89: } xmlLink;
                     90: </pre><p/>
                     91: </div>
                     92:         <hr/>
                     93:         <div class="refsect2" lang="en"><h3><a name="xmlLinkPtr">Typedef </a>xmlLinkPtr</h3><pre class="programlisting"><a href="libxml2-list.html#xmlLink">xmlLink</a> * xmlLinkPtr;
                     94: </pre><p/>
                     95: </div>
                     96:         <hr/>
                     97:         <div class="refsect2" lang="en"><h3><a name="xmlList">Structure </a>xmlList</h3><pre class="programlisting">struct _xmlList {
                     98: The content of this structure is not made public by the API.
                     99: } xmlList;
                    100: </pre><p/>
                    101: </div>
                    102:         <hr/>
                    103:         <div class="refsect2" lang="en"><h3><a name="xmlListPtr">Typedef </a>xmlListPtr</h3><pre class="programlisting"><a href="libxml2-list.html#xmlList">xmlList</a> * xmlListPtr;
                    104: </pre><p/>
                    105: </div>
                    106:         <hr/>
                    107:         <div class="refsect2" lang="en"><h3><a name="xmlListDataCompare"/>Function type xmlListDataCompare</h3><pre class="programlisting">int xmlListDataCompare              (const void * data0, <br/>                                       const void * data1)<br/>
                    108: </pre><p>Callback function used to compare 2 data.</p>
                    109: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>data0</tt></i>:</span></td><td>the first data</td></tr><tr><td><span class="term"><i><tt>data1</tt></i>:</span></td><td>the second data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 is equality, -1 or 1 otherwise depending on the ordering.</td></tr></tbody></table></div></div>
                    110:         <hr/>
                    111:         <div class="refsect2" lang="en"><h3><a name="xmlListDeallocator"/>Function type xmlListDeallocator</h3><pre class="programlisting">void        xmlListDeallocator              (<a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a> lk)<br/>
                    112: </pre><p>Callback function used to free data from a list.</p>
                    113: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>lk</tt></i>:</span></td><td>the data to deallocate</td></tr></tbody></table></div></div>
                    114:         <hr/>
                    115:         <div class="refsect2" lang="en"><h3><a name="xmlListWalker"/>Function type xmlListWalker</h3><pre class="programlisting">int   xmlListWalker                   (const void * data, <br/>                                        const void * user)<br/>
                    116: </pre><p>Callback function used when walking a list with xmlListWalk().</p>
                    117: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>the data found in the list</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td>extra user provided data to the walker</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 to stop walking the list, 1 otherwise.</td></tr></tbody></table></div></div>
                    118:         <hr/>
                    119:         <div class="refsect2" lang="en"><h3><a name="xmlLinkGetData"/>xmlLinkGetData ()</h3><pre class="programlisting">void * xmlLinkGetData                  (<a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a> lk)<br/>
                    120: </pre><p>See Returns.</p>
                    121: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>lk</tt></i>:</span></td><td>a link</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the data referenced from this link</td></tr></tbody></table></div></div>
                    122:         <hr/>
                    123:         <div class="refsect2" lang="en"><h3><a name="xmlListAppend"/>xmlListAppend ()</h3><pre class="programlisting">int      xmlListAppend                   (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    124: </pre><p>Insert data in the ordered list at the end for this value</p>
                    125: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>the data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, 1 in case of failure</td></tr></tbody></table></div></div>
                    126:         <hr/>
                    127:         <div class="refsect2" lang="en"><h3><a name="xmlListClear"/>xmlListClear ()</h3><pre class="programlisting">void       xmlListClear                    (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    128: </pre><p>Remove the all data in the list</p>
                    129: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr></tbody></table></div></div>
                    130:         <hr/>
                    131:         <div class="refsect2" lang="en"><h3><a name="xmlListCopy"/>xmlListCopy ()</h3><pre class="programlisting">int  xmlListCopy                     (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> cur, <br/>                                        const <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> old)<br/>
                    132: </pre><p>Move all the element from the old list in the new list</p>
                    133: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td>the new list</td></tr><tr><td><span class="term"><i><tt>old</tt></i>:</span></td><td>the old list</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success 1 in case of error</td></tr></tbody></table></div></div>
                    134:         <hr/>
                    135:         <div class="refsect2" lang="en"><h3><a name="xmlListCreate"/>xmlListCreate ()</h3><pre class="programlisting"><a href="libxml2-list.html#xmlListPtr">xmlListPtr</a>    xmlListCreate           (<a href="libxml2-list.html#xmlListDeallocator">xmlListDeallocator</a> deallocator, <br/>                                        <a href="libxml2-list.html#xmlListDataCompare">xmlListDataCompare</a> compare)<br/>
                    136: </pre><p>Create a new list</p>
                    137: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>deallocator</tt></i>:</span></td><td>an optional deallocator function</td></tr><tr><td><span class="term"><i><tt>compare</tt></i>:</span></td><td>an optional comparison function</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the new list or NULL in case of error</td></tr></tbody></table></div></div>
                    138:         <hr/>
                    139:         <div class="refsect2" lang="en"><h3><a name="xmlListDelete"/>xmlListDelete ()</h3><pre class="programlisting">void     xmlListDelete                   (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    140: </pre><p>Deletes the list and its associated data</p>
                    141: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr></tbody></table></div></div>
                    142:         <hr/>
                    143:         <div class="refsect2" lang="en"><h3><a name="xmlListDup"/>xmlListDup ()</h3><pre class="programlisting"><a href="libxml2-list.html#xmlListPtr">xmlListPtr</a>  xmlListDup              (const <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> old)<br/>
                    144: </pre><p>Duplicate the list</p>
                    145: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>old</tt></i>:</span></td><td>the list</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>a new copy of the list or NULL in case of error</td></tr></tbody></table></div></div>
                    146:         <hr/>
                    147:         <div class="refsect2" lang="en"><h3><a name="xmlListEmpty"/>xmlListEmpty ()</h3><pre class="programlisting">int        xmlListEmpty                    (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    148: </pre><p>Is the list empty ?</p>
                    149: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>1 if the list is empty, 0 if not empty and -1 in case of error</td></tr></tbody></table></div></div>
                    150:         <hr/>
                    151:         <div class="refsect2" lang="en"><h3><a name="xmlListEnd"/>xmlListEnd ()</h3><pre class="programlisting"><a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a>  xmlListEnd              (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    152: </pre><p>Get the last element in the list</p>
                    153: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the last element in the list, or NULL</td></tr></tbody></table></div></div>
                    154:         <hr/>
                    155:         <div class="refsect2" lang="en"><h3><a name="xmlListFront"/>xmlListFront ()</h3><pre class="programlisting"><a href="libxml2-list.html#xmlLinkPtr">xmlLinkPtr</a>      xmlListFront            (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    156: </pre><p>Get the first element in the list</p>
                    157: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the first element in the list, or NULL</td></tr></tbody></table></div></div>
                    158:         <hr/>
                    159:         <div class="refsect2" lang="en"><h3><a name="xmlListInsert"/>xmlListInsert ()</h3><pre class="programlisting">int      xmlListInsert                   (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    160: </pre><p>Insert data in the ordered list at the beginning for this value</p>
                    161: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>the data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, 1 in case of failure</td></tr></tbody></table></div></div>
                    162:         <hr/>
                    163:         <div class="refsect2" lang="en"><h3><a name="xmlListMerge"/>xmlListMerge ()</h3><pre class="programlisting">void       xmlListMerge                    (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l1, <br/>                                         <a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l2)<br/>
                    164: </pre><p>include all the elements of the second list in the first one and clear the second list</p>
                    165: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l1</tt></i>:</span></td><td>the original list</td></tr><tr><td><span class="term"><i><tt>l2</tt></i>:</span></td><td>the new list</td></tr></tbody></table></div></div>
                    166:         <hr/>
                    167:         <div class="refsect2" lang="en"><h3><a name="xmlListPopBack"/>xmlListPopBack ()</h3><pre class="programlisting">void   xmlListPopBack                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    168: </pre><p>Removes the last element in the list</p>
                    169: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr></tbody></table></div></div>
                    170:         <hr/>
                    171:         <div class="refsect2" lang="en"><h3><a name="xmlListPopFront"/>xmlListPopFront ()</h3><pre class="programlisting">void xmlListPopFront                 (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    172: </pre><p>Removes the first element in the list</p>
                    173: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr></tbody></table></div></div>
                    174:         <hr/>
                    175:         <div class="refsect2" lang="en"><h3><a name="xmlListPushBack"/>xmlListPushBack ()</h3><pre class="programlisting">int  xmlListPushBack                 (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    176: </pre><p>add the new data at the end of the list</p>
                    177: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>new data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>1 if successful, 0 otherwise</td></tr></tbody></table></div></div>
                    178:         <hr/>
                    179:         <div class="refsect2" lang="en"><h3><a name="xmlListPushFront"/>xmlListPushFront ()</h3><pre class="programlisting">int        xmlListPushFront                (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    180: </pre><p>add the new data at the beginning of the list</p>
                    181: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>new data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>1 if successful, 0 otherwise</td></tr></tbody></table></div></div>
                    182:         <hr/>
                    183:         <div class="refsect2" lang="en"><h3><a name="xmlListRemoveAll"/>xmlListRemoveAll ()</h3><pre class="programlisting">int        xmlListRemoveAll                (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    184: </pre><p>Remove the all instance associated to data in the list</p>
                    185: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>list data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of deallocation, or 0 if not found</td></tr></tbody></table></div></div>
                    186:         <hr/>
                    187:         <div class="refsect2" lang="en"><h3><a name="xmlListRemoveFirst"/>xmlListRemoveFirst ()</h3><pre class="programlisting">int    xmlListRemoveFirst              (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    188: </pre><p>Remove the first instance associated to data in the list</p>
                    189: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>list data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>1 if a deallocation occured, or 0 if not found</td></tr></tbody></table></div></div>
                    190:         <hr/>
                    191:         <div class="refsect2" lang="en"><h3><a name="xmlListRemoveLast"/>xmlListRemoveLast ()</h3><pre class="programlisting">int      xmlListRemoveLast               (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    192: </pre><p>Remove the last instance associated to data in the list</p>
                    193: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>list data</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>1 if a deallocation occured, or 0 if not found</td></tr></tbody></table></div></div>
                    194:         <hr/>
                    195:         <div class="refsect2" lang="en"><h3><a name="xmlListReverse"/>xmlListReverse ()</h3><pre class="programlisting">void   xmlListReverse                  (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    196: </pre><p>Reverse the order of the elements in the list</p>
                    197: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr></tbody></table></div></div>
                    198:         <hr/>
                    199:         <div class="refsect2" lang="en"><h3><a name="xmlListReverseSearch"/>xmlListReverseSearch ()</h3><pre class="programlisting">void *     xmlListReverseSearch            (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    200: </pre><p>Search the list in reverse order for an existing value of @data</p>
                    201: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>a search value</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the value associated to @data or NULL in case of error</td></tr></tbody></table></div></div>
                    202:         <hr/>
                    203:         <div class="refsect2" lang="en"><h3><a name="xmlListReverseWalk"/>xmlListReverseWalk ()</h3><pre class="programlisting">void   xmlListReverseWalk              (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  <a href="libxml2-list.html#xmlListWalker">xmlListWalker</a> walker, <br/>                                       const void * user)<br/>
                    204: </pre><p>Walk all the element of the list in reverse order and apply the walker function to it</p>
                    205: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>walker</tt></i>:</span></td><td>a processing function</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td>a user parameter passed to the walker function</td></tr></tbody></table></div></div>
                    206:         <hr/>
                    207:         <div class="refsect2" lang="en"><h3><a name="xmlListSearch"/>xmlListSearch ()</h3><pre class="programlisting">void *   xmlListSearch                   (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  void * data)<br/>
                    208: </pre><p>Search the list for an existing value of @data</p>
                    209: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>a search value</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the value associated to @data or NULL in case of error</td></tr></tbody></table></div></div>
                    210:         <hr/>
                    211:         <div class="refsect2" lang="en"><h3><a name="xmlListSize"/>xmlListSize ()</h3><pre class="programlisting">int  xmlListSize                     (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    212: </pre><p>Get the number of elements in the list</p>
                    213: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>Returns</tt></i>:</span></td><td>the number of elements in the list or -1 in case of error</td></tr></tbody></table></div></div>
                    214:         <hr/>
                    215:         <div class="refsect2" lang="en"><h3><a name="xmlListSort"/>xmlListSort ()</h3><pre class="programlisting">void xmlListSort                     (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l)<br/>
                    216: </pre><p>Sort all the elements in the list</p>
                    217: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr></tbody></table></div></div>
                    218:         <hr/>
                    219:         <div class="refsect2" lang="en"><h3><a name="xmlListWalk"/>xmlListWalk ()</h3><pre class="programlisting">void xmlListWalk                     (<a href="libxml2-list.html#xmlListPtr">xmlListPtr</a> l, <br/>                                  <a href="libxml2-list.html#xmlListWalker">xmlListWalker</a> walker, <br/>                                       const void * user)<br/>
                    220: </pre><p>Walk all the element of the first from first to last and apply the walker function to it</p>
                    221: <div class="variablelist"><table border="0"><col align="left"/><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td>a list</td></tr><tr><td><span class="term"><i><tt>walker</tt></i>:</span></td><td>a processing function</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td>a user parameter passed to the walker function</td></tr></tbody></table></div></div>
                    222:         <hr/>
                    223:       </div>
                    224:     </div>
                    225:   </body>
                    226: </html>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>