glib-keyed-data-lists.html

glid编写实例

<td>
<span class="term"><em class="parameter"><code>q</code></em>&#160;:</span></td>
<td>the <a href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> identifying the data element.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3192752"></a><h3>
<a name="g-datalist-id-remove-no-notify"></a>g_datalist_id_remove_no_notify ()</h3>
<a class="indexterm" name="id3192764"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>    g_datalist_id_remove_no_notify  (<a href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist,
                                             <a href="glib-Quarks.html#GQuark">GQuark</a> key_id);</pre>
<p>
Removes an element, without calling its destroy notification function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>key_id</code></em>&#160;:</span></td>
<td>the <a href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> identifying a data element.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the data previously stored at <em class="parameter"><code>key_id</code></em>, or <code class="literal">NULL</code> if none.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3192865"></a><h3>
<a name="g-datalist-set-data"></a>g_datalist_set_data()</h3>
<a class="indexterm" name="id3192876"></a><pre class="programlisting">#define     g_datalist_set_data(dl, k, d)</pre>
<p>
Sets the data element corresponding to the given string identifier.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></td>
<td>the string to identify the data element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>d</code></em>&#160;:</span></td>
<td>the data element, or <code class="literal">NULL</code> to remove any previous element
corresponding to <em class="parameter"><code>k</code></em>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3192950"></a><h3>
<a name="g-datalist-set-data-full"></a>g_datalist_set_data_full()</h3>
<a class="indexterm" name="id3192961"></a><pre class="programlisting">#define     g_datalist_set_data_full(dl, k, d, f)</pre>
<p>
Sets the data element corresponding to the given string identifier, and the
function to be called when the data element is removed.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></td>
<td>the string to identify the data element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>d</code></em>&#160;:</span></td>
<td>the data element, or <code class="literal">NULL</code> to remove any previous element corresponding to
<em class="parameter"><code>k</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em>&#160;:</span></td>
<td>the function to call when the data element is removed. This
function will be called with the data element and can be used to free any
memory allocated for it. If <em class="parameter"><code>d</code></em> is <code class="literal">NULL</code>, then <em class="parameter"><code>f</code></em> must also be <code class="literal">NULL</code>.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3193077"></a><h3>
<a name="g-datalist-get-data"></a>g_datalist_get_data()</h3>
<a class="indexterm" name="id3193088"></a><pre class="programlisting">#define     g_datalist_get_data(dl, k)</pre>
<p>
Gets a data element, using its string identifer.
This is slower than <a href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data"><code class="function">g_datalist_id_get_data()</code></a> because the string is first
converted to a <a href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></td>
<td>the string identifying a data element.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the data element, or <code class="literal">NULL</code> if it is not found.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3193173"></a><h3>
<a name="g-datalist-remove-data"></a>g_datalist_remove_data()</h3>
<a class="indexterm" name="id3193184"></a><pre class="programlisting">#define     g_datalist_remove_data(dl, k)</pre>
<p>
Removes an element using its string identifier.
The data element's destroy function is called if it has been set.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></td>
<td>the string identifying the data element.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3193234"></a><h3>
<a name="g-datalist-remove-no-notify"></a>g_datalist_remove_no_notify()</h3>
<a class="indexterm" name="id3193245"></a><pre class="programlisting">#define     g_datalist_remove_no_notify(dl, k)</pre>
<p>
Removes an element, without calling its destroy notifier.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dl</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>k</code></em>&#160;:</span></td>
<td>the string identifying the data element.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3193293"></a><h3>
<a name="g-datalist-foreach"></a>g_datalist_foreach ()</h3>
<a class="indexterm" name="id3193304"></a><pre class="programlisting">void        g_datalist_foreach              (<a href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist,
                                             <a href="glib-Datasets.html#GDataForeachFunc">GDataForeachFunc</a> func,
                                             <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
<p>
Calls the given function for each data element of the datalist.
The function is called with each data element's <a href="glib-Quarks.html#GQuark"><span class="type">GQuark</span></a> id and data,
together with the given <em class="parameter"><code>user_data</code></em> parameter.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></td>
<td>a datalist.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>func</code></em>&#160;:</span></td>
<td>the function to call for each data element.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
<td>user data to pass to the function.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3193411"></a><h3>
<a name="g-datalist-clear"></a>g_datalist_clear ()</h3>
<a class="indexterm" name="id3193422"></a><pre class="programlisting">void        g_datalist_clear                (<a href="glib-Keyed-Data-Lists.html#GData">GData</a> **datalist);</pre>
<p>
Frees all the data elements of the datalist.
The data elements' destroy functions are called if they have been set.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>datalist</code></em>&#160;:</span></td>
<td>a datalist.


</td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
<table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle">
<td align="left"><a accesskey="p" href="glib-Quarks.html"><b>&lt;&lt;&#160;Quarks</b></a></td>
<td align="right"><a accesskey="n" href="glib-Datasets.html"><b>Datasets&#160;&gt;&gt;</b></a></td>
</tr></table>
</body>
</html>