Imported Upstream version 2.50.2
[platform/upstream/glib.git] / docs / reference / glib / html / glib-Keyed-Data-Lists.html
index 6e55fd9..1774f85 100644 (file)
@@ -8,7 +8,7 @@
 <link rel="up" href="glib-data-types.html" title="GLib Data Types">
 <link rel="prev" href="glib-Quarks.html" title="Quarks">
 <link rel="next" href="glib-Datasets.html" title="Datasets">
-<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.25.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -214,7 +214,7 @@ be accessed either with a string or with a <a class="link" href="glib-Quarks.htm
 the string.</p>
 <p>The <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> methods are quicker, since the strings have to be
 converted to <a href="glib-Quarks.html#GQuark"><span class="type">GQuarks</span></a> anyway.</p>
-<p>Data lists are used for associating arbitrary data with <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObjects</span></a>,
+<p>Data lists are used for associating arbitrary data with <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObjects</span></a>,
 using <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-set-data"><code class="function">g_object_set_data()</code></a> and related functions.</p>
 <p>To create a datalist, use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-init" title="g_datalist_init ()"><code class="function">g_datalist_init()</code></a>.</p>
 <p>To add data elements to a datalist use <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-set-data" title="g_datalist_id_set_data()"><code class="function">g_datalist_id_set_data()</code></a>,
@@ -237,7 +237,7 @@ g_datalist_init (<em class="parameter"><code><a class="link" href="glib-Keyed-Da
 <p>Resets the datalist to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>. It does not free any memory or call
 any destroy functions.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.2.5"></a><h4>Parameters</h4>
+<a name="g-datalist-init.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -260,7 +260,7 @@ any destroy functions.</p>
 data with the same key is removed, and its destroy function is
 called.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.3.5"></a><h4>Parameters</h4>
+<a name="g-datalist-id-set-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -302,7 +302,7 @@ function to be called when the element is removed from the datalist.
 Any previous data with the same key is removed, and its destroy
 function is called.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.4.5"></a><h4>Parameters</h4>
+<a name="g-datalist-id-set-data-full.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -351,7 +351,7 @@ g_datalist_id_get_data (<em class="parameter"><code><a class="link" href="glib-K
 <p>Retrieves the data element corresponding to <em class="parameter"><code>key_id</code></em>
 .</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.5.5"></a><h4>Parameters</h4>
+<a name="g-datalist-id-get-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -373,7 +373,7 @@ g_datalist_id_get_data (<em class="parameter"><code><a class="link" href="glib-K
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.5.6"></a><h4>Returns</h4>
+<a name="g-datalist-id-get-data.returns"></a><h4>Returns</h4>
 <p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not found.</p>
 </div>
 </div>
@@ -383,7 +383,7 @@ g_datalist_id_get_data (<em class="parameter"><code><a class="link" href="glib-K
 <pre class="programlisting">#define             g_datalist_id_remove_data(dl, q)</pre>
 <p>Removes an element, using its <a class="link" href="glib-Quarks.html#GQuark" title="GQuark"><span class="type">GQuark</span></a> identifier.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.6.5"></a><h4>Parameters</h4>
+<a name="g-datalist-id-remove-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -414,7 +414,7 @@ g_datalist_id_remove_no_notify (<em class="parameter"><code><a class="link" href
 <p>Removes an element, without calling its destroy notification
 function.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.7.5"></a><h4>Parameters</h4>
+<a name="g-datalist-id-remove-no-notify.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -436,7 +436,7 @@ function.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.7.6"></a><h4>Returns</h4>
+<a name="g-datalist-id-remove-no-notify.returns"></a><h4>Returns</h4>
 <p> the data previously stored at <em class="parameter"><code>key_id</code></em>
 , or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if none.</p>
 </div>
@@ -453,7 +453,7 @@ incrementing the reference count, if <em class="parameter"><code>data</code></em
  is a ref-counted
 object.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.8.5"></a><h4>Parameters</h4>
+<a name="GDuplicateFunc.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -475,7 +475,7 @@ object.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.8.6"></a><h4>Returns</h4>
+<a name="GDuplicateFunc.returns"></a><h4>Returns</h4>
 <p> a duplicate of data</p>
 </div>
 </div>
@@ -502,7 +502,7 @@ is not allowed to read or modify the datalist.</p>
 <p>This function can be useful to avoid races when multiple
 threads are using the same datalist and the same key.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.9.8"></a><h4>Parameters</h4>
+<a name="g-datalist-id-dup-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -535,7 +535,7 @@ threads are using the same datalist and the same key.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.9.9"></a><h4>Returns</h4>
+<a name="g-datalist-id-dup-data.returns"></a><h4>Returns</h4>
 <p> the result of calling <em class="parameter"><code>dup_func</code></em>
 on the value
 associated with <em class="parameter"><code>key_id</code></em>
@@ -577,7 +577,7 @@ or may not include using <em class="parameter"><code>old_destroy</code></em>
  as sometimes replacement
 should not destroy the object in the normal way.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.10.7"></a><h4>Parameters</h4>
+<a name="g-datalist-id-replace-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -619,7 +619,7 @@ should not destroy the object in the normal way.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.10.8"></a><h4>Returns</h4>
+<a name="g-datalist-id-replace-data.returns"></a><h4>Returns</h4>
 <p> <a class="link" href="glib-Standard-Macros.html#TRUE:CAPS" title="TRUE"><code class="literal">TRUE</code></a> if the existing value for <em class="parameter"><code>key_id</code></em>
 was replaced
 by <em class="parameter"><code>newval</code></em>
@@ -633,7 +633,7 @@ by <em class="parameter"><code>newval</code></em>
 <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="refsect3">
-<a name="id-1.6.16.7.11.5"></a><h4>Parameters</h4>
+<a name="g-datalist-set-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -669,7 +669,7 @@ corresponding to <em class="parameter"><code>k</code></em>
 <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="refsect3">
-<a name="id-1.6.16.7.12.5"></a><h4>Parameters</h4>
+<a name="g-datalist-set-data-full.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -717,7 +717,7 @@ g_datalist_get_data (<em class="parameter"><code><a class="link" href="glib-Keye
 <p>Gets a data element, using its string identifier. This is slower than
 <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-id-get-data" title="g_datalist_id_get_data ()"><code class="function">g_datalist_id_get_data()</code></a> because it compares strings.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.13.5"></a><h4>Parameters</h4>
+<a name="g-datalist-get-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -739,7 +739,7 @@ g_datalist_get_data (<em class="parameter"><code><a class="link" href="glib-Keye
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.13.6"></a><h4>Returns</h4>
+<a name="g-datalist-get-data.returns"></a><h4>Returns</h4>
 <p> the data element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not found.</p>
 </div>
 </div>
@@ -750,7 +750,7 @@ g_datalist_get_data (<em class="parameter"><code><a class="link" href="glib-Keye
 <p>Removes an element using its string identifier. The data element's
 destroy function is called if it has been set.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.14.5"></a><h4>Parameters</h4>
+<a name="g-datalist-remove-data.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -778,7 +778,7 @@ destroy function is called if it has been set.</p>
 <pre class="programlisting">#define             g_datalist_remove_no_notify(dl, k)</pre>
 <p>Removes an element, without calling its destroy notifier.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.15.5"></a><h4>Parameters</h4>
+<a name="g-datalist-remove-no-notify.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -816,7 +816,7 @@ function is NOT thread-safe. So unless <em class="parameter"><code>datalist</cod
 from any modifications during invocation of this function, it should
 not be called.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.16.5"></a><h4>Parameters</h4>
+<a name="g-datalist-foreach.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -852,7 +852,7 @@ g_datalist_clear (<em class="parameter"><code><a class="link" href="glib-Keyed-D
 The data elements' destroy functions are called
 if they have been set.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.17.5"></a><h4>Parameters</h4>
+<a name="g-datalist-clear.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -877,10 +877,10 @@ g_datalist_set_flags (<em class="parameter"><code><a class="link" href="glib-Key
 to keep a small number of boolean flags in an object with
 a data list without using any additional space. It is
 not generally useful except in circumstances where space
-is very tight. (It is used in the base <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"><span class="type">GObject</span></a> type, for
+is very tight. (It is used in the base <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> type, for
 example.)</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.18.5"></a><h4>Parameters</h4>
+<a name="g-datalist-set-flags.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -916,7 +916,7 @@ g_datalist_unset_flags (<em class="parameter"><code><a class="link" href="glib-K
                         <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#guint" title="guint ()"><span class="type">guint</span></a> flags</code></em>);</pre>
 <p>Turns off flag values for a data list. See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-unset-flags" title="g_datalist_unset_flags ()"><code class="function">g_datalist_unset_flags()</code></a></p>
 <div class="refsect3">
-<a name="id-1.6.16.7.19.5"></a><h4>Parameters</h4>
+<a name="g-datalist-unset-flags.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -952,7 +952,7 @@ g_datalist_get_flags (<em class="parameter"><code><a class="link" href="glib-Key
 <p>Gets flags values packed in together with the datalist.
 See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags" title="g_datalist_set_flags ()"><code class="function">g_datalist_set_flags()</code></a>.</p>
 <div class="refsect3">
-<a name="id-1.6.16.7.20.5"></a><h4>Parameters</h4>
+<a name="g-datalist-get-flags.parameters"></a><h4>Parameters</h4>
 <div class="informaltable"><table class="informaltable" width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -967,7 +967,7 @@ See <a class="link" href="glib-Keyed-Data-Lists.html#g-datalist-set-flags" title
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.6.16.7.20.6"></a><h4>Returns</h4>
+<a name="g-datalist-get-flags.returns"></a><h4>Returns</h4>
 <p> the flags of the datalist</p>
 </div>
 <p class="since">Since: <a class="link" href="api-index-2-8.html#api-index-2.8">2.8</a></p>
@@ -994,6 +994,6 @@ flags &amp; ~G_DATALIST_FLAGS_MASK != 0 is an error.</p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.24</div>
+<hr>Generated by GTK-Doc V1.25.1</div>
 </body>
 </html>
\ No newline at end of file