golden hour
/opt/alt/libxml2/usr/share/gtk-doc/html/libxml2
⬆️ Go Up
Upload
File/Folder
Size
Actions
general.html
4.93 KB
Del
OK
home.png
654 B
Del
OK
index.html
3.55 KB
Del
OK
left.png
459 B
Del
OK
libxml2-HTMLparser.html
56.31 KB
Del
OK
libxml2-HTMLtree.html
23.47 KB
Del
OK
libxml2-SAX.html
36.87 KB
Del
OK
libxml2-SAX2.html
37.64 KB
Del
OK
libxml2-c14n.html
12.87 KB
Del
OK
libxml2-catalog.html
35.23 KB
Del
OK
libxml2-chvalid.html
18.75 KB
Del
OK
libxml2-debugXML.html
32.19 KB
Del
OK
libxml2-dict.html
13.27 KB
Del
OK
libxml2-encoding.html
28.45 KB
Del
OK
libxml2-entities.html
22.17 KB
Del
OK
libxml2-globals.html
34.5 KB
Del
OK
libxml2-hash.html
41.58 KB
Del
OK
libxml2-list.html
24.5 KB
Del
OK
libxml2-nanoftp.html
21.59 KB
Del
OK
libxml2-nanohttp.html
15.84 KB
Del
OK
libxml2-parser.html
134.35 KB
Del
OK
libxml2-parserInternals.html
121.83 KB
Del
OK
libxml2-pattern.html
18.48 KB
Del
OK
libxml2-relaxng.html
34.28 KB
Del
OK
libxml2-schemasInternals.html
61.84 KB
Del
OK
libxml2-schematron.html
16.23 KB
Del
OK
libxml2-threads.html
12.55 KB
Del
OK
libxml2-tree.html
229.88 KB
Del
OK
libxml2-uri.html
17.6 KB
Del
OK
libxml2-valid.html
96.1 KB
Del
OK
libxml2-xinclude.html
15.02 KB
Del
OK
libxml2-xlink.html
16.47 KB
Del
OK
libxml2-xmlIO.html
56.45 KB
Del
OK
libxml2-xmlautomata.html
34.03 KB
Del
OK
libxml2-xmlerror.html
82.44 KB
Del
OK
libxml2-xmlexports.html
3.26 KB
Del
OK
libxml2-xmlmemory.html
23.53 KB
Del
OK
libxml2-xmlmodule.html
6.77 KB
Del
OK
libxml2-xmlreader.html
105.41 KB
Del
OK
libxml2-xmlregexp.html
40.59 KB
Del
OK
libxml2-xmlsave.html
14.06 KB
Del
OK
libxml2-xmlschemas.html
41.08 KB
Del
OK
libxml2-xmlschemastypes.html
43.41 KB
Del
OK
libxml2-xmlstring.html
33.82 KB
Del
OK
libxml2-xmlunicode.html
103.86 KB
Del
OK
libxml2-xmlversion.html
18.02 KB
Del
OK
libxml2-xmlwriter.html
109.48 KB
Del
OK
libxml2-xpath.html
60.84 KB
Del
OK
libxml2-xpathInternals.html
141.12 KB
Del
OK
libxml2-xpointer.html
24.62 KB
Del
OK
libxml2.devhelp2
379.48 KB
Del
OK
right.png
472 B
Del
OK
style.css
820 B
Del
OK
up.png
406 B
Del
OK
Edit: libxml2-dict.html
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>dict: string dictionary</title> <meta name="generator" content="Libxml2 devhelp stylesheet"> <link rel="start" href="index.html" title="libxml2 Reference Manual"> <link rel="up" href="general.html" title="API"> <link rel="stylesheet" href="style.css" type="text/css"> <link rel="chapter" href="general.html" title="API"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"> <td><a accesskey="p" href="libxml2-debugXML.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td> <td><a accesskey="u" href="general.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td> <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td> <td><a accesskey="n" href="libxml2-encoding.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td> <th width="100%" align="center">libxml2 Reference Manual</th> </tr></table> <h2><span class="refentrytitle">dict</span></h2> <p>dict - string dictionary</p> <p>dictionary of reusable strings, just used to avoid allocation and freeing operations. </p> <p>Author(s): Daniel Veillard </p> <div class="refsynopsisdiv"> <h2>Synopsis</h2> <pre class="synopsis">typedef struct _xmlDict <a href="#xmlDict">xmlDict</a>; typedef <a href="libxml2-dict.html#xmlDict">xmlDict</a> * <a href="#xmlDictPtr">xmlDictPtr</a>; void <a href="#xmlDictCleanup">xmlDictCleanup</a> (void); <a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> <a href="#xmlDictCreate">xmlDictCreate</a> (void); <a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> <a href="#xmlDictCreateSub">xmlDictCreateSub</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> sub); const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * <a href="#xmlDictExists">xmlDictExists</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br> int len); void <a href="#xmlDictFree">xmlDictFree</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict); size_t <a href="#xmlDictGetUsage">xmlDictGetUsage</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict); const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * <a href="#xmlDictLookup">xmlDictLookup</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br> int len); int <a href="#xmlDictOwns">xmlDictOwns</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * str); const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * <a href="#xmlDictQLookup">xmlDictQLookup</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * prefix, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name); int <a href="#xmlDictReference">xmlDictReference</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict); size_t <a href="#xmlDictSetLimit">xmlDictSetLimit</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> size_t limit); int <a href="#xmlDictSize">xmlDictSize</a> (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict); int <a href="#xmlInitializeDict">xmlInitializeDict</a> (void); </pre> </div> <div class="refsect1" lang="en"><h2>Description</h2></div> <div class="refsect1" lang="en"> <h2>Details</h2> <div class="refsect2" lang="en"> <div class="refsect2" lang="en"> <h3> <a name="xmlDict">Structure </a>xmlDict</h3> <pre class="programlisting">struct _xmlDict { The content of this structure is not made public by the API. } xmlDict; </pre> <p></p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictPtr">Typedef </a>xmlDictPtr</h3> <pre class="programlisting"><a href="libxml2-dict.html#xmlDict">xmlDict</a> * xmlDictPtr; </pre> <p></p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictCleanup"></a>xmlDictCleanup ()</h3> <pre class="programlisting">void xmlDictCleanup (void)<br> </pre> <p>DEPRECATED: This function will be made private. Call <a href="libxml2-parser.html#xmlCleanupParser">xmlCleanupParser</a> to free global state but see the warnings there. <a href="libxml2-parser.html#xmlCleanupParser">xmlCleanupParser</a> should be only called once at program exit. In most cases, you don't have call cleanup functions at all. Free the dictionary mutex. Do not call unless sure the library is not in use anymore !</p> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictCreate"></a>xmlDictCreate ()</h3> <pre class="programlisting"><a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> xmlDictCreate (void)<br> </pre> <p>Create a new dictionary</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the newly created dictionary, or NULL if an error occurred.</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictCreateSub"></a>xmlDictCreateSub ()</h3> <pre class="programlisting"><a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> xmlDictCreateSub (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> sub)<br> </pre> <p>Create a new dictionary, inheriting strings from the read-only dictionary @sub. On lookup, strings are first searched in the new dictionary, then in @sub, and if not found are created in the new dictionary.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>sub</tt></i>:</span></td> <td>an existing dictionary</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the newly created dictionary, or NULL if an error occurred.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictExists"></a>xmlDictExists ()</h3> <pre class="programlisting">const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * xmlDictExists (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br> int len)<br> </pre> <p>Check if the @name exists in the dictionary @dict.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>name</tt></i>:</span></td> <td>the name of the userdata</td> </tr> <tr> <td><span class="term"><i><tt>len</tt></i>:</span></td> <td>the length of the name, if -1 it is recomputed</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the internal copy of the name or NULL if not found.</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictFree"></a>xmlDictFree ()</h3> <pre class="programlisting">void xmlDictFree (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict)<br> </pre> <p>Free the hash @dict and its contents. The userdata is deallocated with @f if provided.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr></tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictGetUsage"></a>xmlDictGetUsage ()</h3> <pre class="programlisting">size_t xmlDictGetUsage (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict)<br> </pre> <p>Get how much memory is used by a dictionary for strings Added in 2.9.0</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the amount of strings allocated</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictLookup"></a>xmlDictLookup ()</h3> <pre class="programlisting">const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * xmlDictLookup (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name, <br> int len)<br> </pre> <p>Add the @name to the dictionary @dict if not present.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>name</tt></i>:</span></td> <td>the name of the userdata</td> </tr> <tr> <td><span class="term"><i><tt>len</tt></i>:</span></td> <td>the length of the name, if -1 it is recomputed</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the internal copy of the name or NULL in case of internal error</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictOwns"></a>xmlDictOwns ()</h3> <pre class="programlisting">int xmlDictOwns (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * str)<br> </pre> <p>check if a string is owned by the dictionary</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>str</tt></i>:</span></td> <td>the string</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>1 if true, 0 if false and -1 in case of error -1 in case of error</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictQLookup"></a>xmlDictQLookup ()</h3> <pre class="programlisting">const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * xmlDictQLookup (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * prefix, <br> const <a href="libxml2-xmlstring.html#xmlChar">xmlChar</a> * name)<br> </pre> <p>Add the QName @prefix:@name to the hash @dict if not present.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>prefix</tt></i>:</span></td> <td>the prefix</td> </tr> <tr> <td><span class="term"><i><tt>name</tt></i>:</span></td> <td>the name</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the internal copy of the QName or NULL in case of internal error</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictReference"></a>xmlDictReference ()</h3> <pre class="programlisting">int xmlDictReference (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict)<br> </pre> <p>Increment the <a href="libxml2-SAX.html#reference">reference</a> counter of a dictionary</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>0 in case of success and -1 in case of error</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictSetLimit"></a>xmlDictSetLimit ()</h3> <pre class="programlisting">size_t xmlDictSetLimit (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict, <br> size_t limit)<br> </pre> <p>Set a size limit for the dictionary Added in 2.9.0</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>limit</tt></i>:</span></td> <td>the limit in bytes</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the previous limit of the dictionary or 0</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlDictSize"></a>xmlDictSize ()</h3> <pre class="programlisting">int xmlDictSize (<a href="libxml2-dict.html#xmlDictPtr">xmlDictPtr</a> dict)<br> </pre> <p>Query the number of elements installed in the hash @dict.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody> <tr> <td><span class="term"><i><tt>dict</tt></i>:</span></td> <td>the dictionary</td> </tr> <tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>the number of elements in the dictionary or -1 in case of error</td> </tr> </tbody> </table></div> </div> <hr> <div class="refsect2" lang="en"> <h3> <a name="xmlInitializeDict"></a>xmlInitializeDict ()</h3> <pre class="programlisting">int xmlInitializeDict (void)<br> </pre> <p>DEPRECATED: This function will be made private. Call <a href="libxml2-parser.html#xmlInitParser">xmlInitParser</a> to initialize the library. Do the dictionary mutex initialization.</p> <div class="variablelist"><table border="0"> <col align="left"> <tbody><tr> <td><span class="term"><i><tt>Returns</tt></i>:</span></td> <td>0 if initialization was already done, and 1 if that call led to the initialization</td> </tr></tbody> </table></div> </div> <hr> </div> </div> </body> </html>
Save
