← Back to branch summary

~ubuntu-branches/ubuntu/trusty/glib2.0/trusty-proposed

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Singly-Linked-Lists.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-03-09 11:28:22 UTC
  • mfrom: (3.4.8 experimental)
  • Revision ID: james.westby@ubuntu.com-20100309112822-j4n0v3xbtsup8s97
Tags: 2.23.5-1ubuntu1
* Resync on Debian
* debian/patches/01_gettext-desktopfiles.patch:
  - updated to use gettext for X-GNOME-Fullname too
* debian/patches/71_gio_launch_handler.patch:
  - new gio default launch handle feature required for wncksync
* debian/control.in, 
  debian/patches/80-gtester-subunit.patch:
  - gtester-report subunit support
* debian/libglib2.0-0.symbols:
  - updated the symbols list for the gio launcher handler
* debian/rules:
  - don't break build on test suite errors, debian recently activated this but
    the build breaks even when there is no error in the testsuite

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Singly-Linked-Lists.html
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
5
<title>Singly-Linked Lists</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
7
7
<link rel="home" href="index.html" title="GLib Reference Manual">
8
8
<link rel="up" href="glib-data-types.html" title="GLib Data Types">
9
9
<link rel="prev" href="glib-Doubly-Linked-Lists.html" title="Doubly-Linked Lists">
10
10
<link rel="next" href="glib-Double-ended-Queues.html" title="Double-ended Queues">
11
 
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="glib.html" title="GLib Overview">
14
14
<link rel="chapter" href="glib-fundamentals.html" title="GLib Fundamentals">
42
42
</tr>
43
43
<tr><td colspan="5" class="shortcuts">
44
44
<a href="#glib-Singly-Linked-Lists.synopsis" class="shortcut">Top</a>
45
 
                   | 
46
 
                  <a href="#glib-Singly-Linked-Lists.description" class="shortcut">Description</a>
 
45
                 | 
 
46
                <a href="#glib-Singly-Linked-Lists.description" class="shortcut">Description</a>
47
47
</td></tr>
48
48
</table>
49
49
<div class="refentry" title="Singly-Linked Lists">
60
60
<div class="refsynopsisdiv" title="Synopsis">
61
61
<a name="glib-Singly-Linked-Lists.synopsis"></a><h2>Synopsis</h2>
62
62
<pre class="synopsis">
 
63
 
63
64
#include &lt;glib.h&gt;
64
65
 
65
66
                    <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>;
66
67
 
67
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-alloc" title="g_slist_alloc ()">g_slist_alloc</a>                       (void);
68
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-append" title="g_slist_append ()">g_slist_append</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
69
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data);
70
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-prepend" title="g_slist_prepend ()">g_slist_prepend</a>                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
71
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data);
72
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert" title="g_slist_insert ()">g_slist_insert</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
73
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data,
74
 
                                                         <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> position);
75
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-before" title="g_slist_insert_before ()">g_slist_insert_before</a>               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *slist,
76
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *sibling,
77
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data);
78
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-sorted" title="g_slist_insert_sorted ()">g_slist_insert_sorted</a>               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
79
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data,
80
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()"><span class="returnvalue">GCompareFunc</span></a> func);
81
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove" title="g_slist_remove ()">g_slist_remove</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
82
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);
83
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove-link" title="g_slist_remove_link ()">g_slist_remove_link</a>                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
84
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *link_);
85
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-delete-link" title="g_slist_delete_link ()">g_slist_delete_link</a>                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
86
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *link_);
87
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove-all" title="g_slist_remove_all ()">g_slist_remove_all</a>                  (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
88
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);
89
 
<span class="returnvalue">void</span>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free" title="g_slist_free ()">g_slist_free</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);
90
 
<span class="returnvalue">void</span>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free-1" title="g_slist_free_1 ()">g_slist_free_1</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);
 
68
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-alloc" title="g_slist_alloc ()">g_slist_alloc</a>                       (void);
 
69
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-append" title="g_slist_append ()">g_slist_append</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
70
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
 
71
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-prepend" title="g_slist_prepend ()">g_slist_prepend</a>                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
72
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
 
73
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert" title="g_slist_insert ()">g_slist_insert</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
74
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
75
                                                         <a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> position);
 
76
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-before" title="g_slist_insert_before ()">g_slist_insert_before</a>               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *slist,
 
77
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *sibling,
 
78
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);
 
79
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-sorted" title="g_slist_insert_sorted ()">g_slist_insert_sorted</a>               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
80
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
81
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()">GCompareFunc</a> func);
 
82
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove" title="g_slist_remove ()">g_slist_remove</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
83
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);
 
84
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove-link" title="g_slist_remove_link ()">g_slist_remove_link</a>                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
85
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *link_);
 
86
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-delete-link" title="g_slist_delete_link ()">g_slist_delete_link</a>                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
87
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *link_);
 
88
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove-all" title="g_slist_remove_all ()">g_slist_remove_all</a>                  (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
89
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);
 
90
void                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free" title="g_slist_free ()">g_slist_free</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);
 
91
void                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free-1" title="g_slist_free_1 ()">g_slist_free_1</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);
91
92
#define             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free1" title="g_slist_free1">g_slist_free1</a>
92
93
 
93
 
<a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>               <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-length" title="g_slist_length ()">g_slist_length</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);
94
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-copy" title="g_slist_copy ()">g_slist_copy</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);
95
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-reverse" title="g_slist_reverse ()">g_slist_reverse</a>                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);
96
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-sorted-with-data" title="g_slist_insert_sorted_with_data ()">g_slist_insert_sorted_with_data</a>     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
97
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data,
98
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="returnvalue">GCompareDataFunc</span></a> func,
99
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> user_data);
100
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-sort" title="g_slist_sort ()">g_slist_sort</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
101
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()"><span class="returnvalue">GCompareFunc</span></a> compare_func);
102
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-sort-with-data" title="g_slist_sort_with_data ()">g_slist_sort_with_data</a>              (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
103
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="returnvalue">GCompareDataFunc</span></a> compare_func,
104
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> user_data);
105
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-concat" title="g_slist_concat ()">g_slist_concat</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list1,
106
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list2);
107
 
<span class="returnvalue">void</span>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-foreach" title="g_slist_foreach ()">g_slist_foreach</a>                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
108
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="returnvalue">GFunc</span></a> func,
109
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 
94
<a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-length" title="g_slist_length ()">g_slist_length</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);
 
95
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-copy" title="g_slist_copy ()">g_slist_copy</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);
 
96
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-reverse" title="g_slist_reverse ()">g_slist_reverse</a>                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);
 
97
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-sorted-with-data" title="g_slist_insert_sorted_with_data ()">g_slist_insert_sorted_with_data</a>     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
98
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
99
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> func,
 
100
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
 
101
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-sort" title="g_slist_sort ()">g_slist_sort</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
102
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()">GCompareFunc</a> compare_func);
 
103
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-sort-with-data" title="g_slist_sort_with_data ()">g_slist_sort_with_data</a>              (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
104
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> compare_func,
 
105
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
 
106
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-concat" title="g_slist_concat ()">g_slist_concat</a>                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list1,
 
107
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list2);
 
108
void                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-foreach" title="g_slist_foreach ()">g_slist_foreach</a>                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
109
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()">GFunc</a> func,
 
110
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);
110
111
 
111
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-last" title="g_slist_last ()">g_slist_last</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);
 
112
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-last" title="g_slist_last ()">g_slist_last</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);
112
113
#define             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-next" title="g_slist_next()">g_slist_next</a>                        (slist)
113
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-nth" title="g_slist_nth ()">g_slist_nth</a>                         (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
114
 
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> n);
115
 
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>            <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-nth-data" title="g_slist_nth_data ()">g_slist_nth_data</a>                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
116
 
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> n);
117
 
 
118
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-find" title="g_slist_find ()">g_slist_find</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
119
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);
120
 
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-find-custom" title="g_slist_find_custom ()">g_slist_find_custom</a>                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
121
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data,
122
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()"><span class="returnvalue">GCompareFunc</span></a> func);
123
 
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-position" title="g_slist_position ()">g_slist_position</a>                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
124
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *llink);
125
 
<a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-index" title="g_slist_index ()">g_slist_index</a>                       (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
126
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);
127
 
 
128
 
<span class="returnvalue">void</span>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-push-allocator" title="g_slist_push_allocator ()">g_slist_push_allocator</a>              (<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> dummy);
129
 
<span class="returnvalue">void</span>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-pop-allocator" title="g_slist_pop_allocator ()">g_slist_pop_allocator</a>               (void);
 
114
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-nth" title="g_slist_nth ()">g_slist_nth</a>                         (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
115
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n);
 
116
<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a>            <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-nth-data" title="g_slist_nth_data ()">g_slist_nth_data</a>                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
117
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n);
 
118
 
 
119
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-find" title="g_slist_find ()">g_slist_find</a>                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
120
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);
 
121
<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-find-custom" title="g_slist_find_custom ()">g_slist_find_custom</a>                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
122
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data,
 
123
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()">GCompareFunc</a> func);
 
124
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-position" title="g_slist_position ()">g_slist_position</a>                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
125
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *llink);
 
126
<a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-index" title="g_slist_index ()">g_slist_index</a>                       (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
127
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);
 
128
 
 
129
void                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-push-allocator" title="g_slist_push_allocator ()">g_slist_push_allocator</a>              (<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> dummy);
 
130
void                <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-pop-allocator" title="g_slist_pop_allocator ()">g_slist_pop_allocator</a>               (void);
130
131
</pre>
131
132
</div>
132
133
<div class="refsect1" title="Description">
157
158
elements return the new start of the list, which may have changed.
158
159
</p>
159
160
<p>
160
 
There is no function to create a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>. <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> is considered to be
161
 
the empty list so you simply set a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>* to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>.
 
161
There is no function to create a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>. <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> is considered to be
 
162
the empty list so you simply set a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>* to <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>.
162
163
</p>
163
164
<p>
164
165
To add elements, use <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-append" title="g_slist_append ()"><code class="function">g_slist_append()</code></a>, <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-prepend" title="g_slist_prepend ()"><code class="function">g_slist_prepend()</code></a>,
182
183
</p>
183
184
<p>
184
185
To free the entire list, use <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free" title="g_slist_free ()"><code class="function">g_slist_free()</code></a>.</p>
 
186
<p>
 
187
</p>
185
188
</div>
186
189
<div class="refsect1" title="Details">
187
190
<a name="glib-Singly-Linked-Lists.details"></a><h2>Details</h2>
195
198
<p>
196
199
The <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> struct is used for each element in the singly-linked
197
200
list.</p>
 
201
<p>
 
202
</p>
198
203
<div class="variablelist"><table border="0">
199
204
<col align="left" valign="top">
200
205
<tbody>
201
206
<tr>
202
 
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="type">gpointer</span></a> <em class="structfield"><code><a name="GSList.data"></a>data</code></em>;</span></p></td>
 
207
<td><p><span class="term"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> <em class="structfield"><code>data</code></em>;</span></p></td>
203
208
<td> holds the element's data, which can be a pointer to any kind
204
209
       of data, or any integer value using the <a class="link" href="glib-Type-Conversion-Macros.html" title="Type Conversion Macros">Type Conversion
205
210
       Macros</a>.
206
211
</td>
207
212
</tr>
208
213
<tr>
209
 
<td><p><span class="term"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> *<em class="structfield"><code><a name="GSList.next"></a>next</code></em>;</span></p></td>
 
214
<td><p><span class="term"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *<em class="structfield"><code>next</code></em>;</span></p></td>
210
215
<td> contains the link to the next element in the list.
211
216
</td>
212
217
</tr>
216
221
<hr>
217
222
<div class="refsect2" title="g_slist_alloc ()">
218
223
<a name="g-slist-alloc"></a><h3>g_slist_alloc ()</h3>
219
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_alloc                       (void);</pre>
 
224
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_alloc                       (void);</pre>
220
225
<p>
221
226
Allocates space for one <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> element. It is called by the
222
227
<a class="link" href="glib-Singly-Linked-Lists.html#g-slist-append" title="g_slist_append ()"><code class="function">g_slist_append()</code></a>, <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-prepend" title="g_slist_prepend ()"><code class="function">g_slist_prepend()</code></a>, <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert" title="g_slist_insert ()"><code class="function">g_slist_insert()</code></a> and
223
228
<a class="link" href="glib-Singly-Linked-Lists.html#g-slist-insert-sorted" title="g_slist_insert_sorted ()"><code class="function">g_slist_insert_sorted()</code></a> functions and so is rarely used on its own.</p>
 
229
<p>
 
230
</p>
224
231
<div class="variablelist"><table border="0">
225
232
<col align="left" valign="top">
226
233
<tbody><tr>
233
240
<hr>
234
241
<div class="refsect2" title="g_slist_append ()">
235
242
<a name="g-slist-append"></a><h3>g_slist_append ()</h3>
236
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_append                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
237
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
 
243
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_append                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
244
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
238
245
<p>
239
246
Adds a new element on to the end of the list.
240
247
</p>
276
283
number_list = g_slist_append (number_list, GINT_TO_POINTER (27));
277
284
number_list = g_slist_append (number_list, GINT_TO_POINTER (14));
278
285
</pre></div>
 
286
<p>
 
287
</p>
279
288
<div class="variablelist"><table border="0">
280
289
<col align="left" valign="top">
281
290
<tbody>
300
309
<hr>
301
310
<div class="refsect2" title="g_slist_prepend ()">
302
311
<a name="g-slist-prepend"></a><h3>g_slist_prepend ()</h3>
303
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_prepend                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
304
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
 
312
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_prepend                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
313
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
305
314
<p>
306
315
Adds a new element on to the start of the list.
307
316
</p>
324
333
list = g_slist_prepend (list, "last");
325
334
list = g_slist_prepend (list, "first");
326
335
</pre></div>
 
336
<p>
 
337
</p>
327
338
<div class="variablelist"><table border="0">
328
339
<col align="left" valign="top">
329
340
<tbody>
348
359
<hr>
349
360
<div class="refsect2" title="g_slist_insert ()">
350
361
<a name="g-slist-insert"></a><h3>g_slist_insert ()</h3>
351
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_insert                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
352
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data,
353
 
                                                         <a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a> position);</pre>
 
362
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_insert                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
363
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
364
                                                         <a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a> position);</pre>
354
365
<p>
355
366
Inserts a new element into the list at the given position.</p>
 
367
<p>
 
368
</p>
356
369
<div class="variablelist"><table border="0">
357
370
<col align="left" valign="top">
358
371
<tbody>
385
398
<hr>
386
399
<div class="refsect2" title="g_slist_insert_before ()">
387
400
<a name="g-slist-insert-before"></a><h3>g_slist_insert_before ()</h3>
388
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_insert_before               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *slist,
389
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *sibling,
390
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data);</pre>
 
401
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_insert_before               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *slist,
 
402
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *sibling,
 
403
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data);</pre>
391
404
<p>
392
405
Inserts a node before <em class="parameter"><code>sibling</code></em> containing <em class="parameter"><code>data</code></em>.</p>
 
406
<p>
 
407
</p>
393
408
<div class="variablelist"><table border="0">
394
409
<col align="left" valign="top">
395
410
<tbody>
419
434
<hr>
420
435
<div class="refsect2" title="g_slist_insert_sorted ()">
421
436
<a name="g-slist-insert-sorted"></a><h3>g_slist_insert_sorted ()</h3>
422
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_insert_sorted               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
423
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data,
424
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()"><span class="returnvalue">GCompareFunc</span></a> func);</pre>
 
437
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_insert_sorted               (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
438
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
439
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()">GCompareFunc</a> func);</pre>
425
440
<p>
426
441
Inserts a new element into the list, using the given 
427
442
comparison function to determine its position.</p>
 
443
<p>
 
444
</p>
428
445
<div class="variablelist"><table border="0">
429
446
<col align="left" valign="top">
430
447
<tbody>
456
473
<hr>
457
474
<div class="refsect2" title="g_slist_remove ()">
458
475
<a name="g-slist-remove"></a><h3>g_slist_remove ()</h3>
459
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_remove                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
460
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);</pre>
 
476
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_remove                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
477
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);</pre>
461
478
<p>
462
479
Removes an element from a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
463
480
If two elements contain the same data, only the first is removed.
464
481
If none of the elements contain the data, the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> is unchanged.</p>
 
482
<p>
 
483
</p>
465
484
<div class="variablelist"><table border="0">
466
485
<col align="left" valign="top">
467
486
<tbody>
486
505
<hr>
487
506
<div class="refsect2" title="g_slist_remove_link ()">
488
507
<a name="g-slist-remove-link"></a><h3>g_slist_remove_link ()</h3>
489
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_remove_link                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
490
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *link_);</pre>
 
508
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_remove_link                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
509
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *link_);</pre>
491
510
<p>
492
511
Removes an element from a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>, without 
493
512
freeing the element. The removed element's next 
494
 
link is set to <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a>, so that it becomes a
 
513
link is set to <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a>, so that it becomes a
495
514
self-contained list with one element.</p>
 
515
<p>
 
516
</p>
496
517
<div class="variablelist"><table border="0">
497
518
<col align="left" valign="top">
498
519
<tbody>
517
538
<hr>
518
539
<div class="refsect2" title="g_slist_delete_link ()">
519
540
<a name="g-slist-delete-link"></a><h3>g_slist_delete_link ()</h3>
520
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_delete_link                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
521
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *link_);</pre>
 
541
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_delete_link                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
542
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *link_);</pre>
522
543
<p>
523
544
Removes the node link_ from the list and frees it. 
524
545
Compare this to <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove-link" title="g_slist_remove_link ()"><code class="function">g_slist_remove_link()</code></a> which removes the node 
525
546
without freeing it.</p>
 
547
<p>
 
548
</p>
526
549
<div class="variablelist"><table border="0">
527
550
<col align="left" valign="top">
528
551
<tbody>
547
570
<hr>
548
571
<div class="refsect2" title="g_slist_remove_all ()">
549
572
<a name="g-slist-remove-all"></a><h3>g_slist_remove_all ()</h3>
550
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_remove_all                  (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
551
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);</pre>
 
573
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_remove_all                  (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
574
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);</pre>
552
575
<p>
553
576
Removes all list nodes with data equal to <em class="parameter"><code>data</code></em>. 
554
577
Returns the new head of the list. Contrast with 
555
578
<a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove" title="g_slist_remove ()"><code class="function">g_slist_remove()</code></a> which removes only the first node 
556
579
matching the given data.</p>
 
580
<p>
 
581
</p>
557
582
<div class="variablelist"><table border="0">
558
583
<col align="left" valign="top">
559
584
<tbody>
578
603
<hr>
579
604
<div class="refsect2" title="g_slist_free ()">
580
605
<a name="g-slist-free"></a><h3>g_slist_free ()</h3>
581
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_slist_free                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);</pre>
 
606
<pre class="programlisting">void                g_slist_free                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);</pre>
582
607
<p>
583
608
Frees all of the memory used by a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
584
609
The freed elements are returned to the slice allocator.</p>
 
610
<p>
 
611
</p>
585
612
<div class="variablelist"><table border="0">
586
613
<col align="left" valign="top">
587
614
<tbody><tr>
594
621
<hr>
595
622
<div class="refsect2" title="g_slist_free_1 ()">
596
623
<a name="g-slist-free-1"></a><h3>g_slist_free_1 ()</h3>
597
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_slist_free_1                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);</pre>
 
624
<pre class="programlisting">void                g_slist_free_1                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);</pre>
598
625
<p>
599
626
Frees one <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> element.
600
627
It is usually used after <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-remove-link" title="g_slist_remove_link ()"><code class="function">g_slist_remove_link()</code></a>.</p>
 
628
<p>
 
629
</p>
601
630
<div class="variablelist"><table border="0">
602
631
<col align="left" valign="top">
603
632
<tbody><tr>
613
642
<pre class="programlisting">#define             g_slist_free1</pre>
614
643
<p>
615
644
A macro which does the same as <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-free-1" title="g_slist_free_1 ()"><code class="function">g_slist_free_1()</code></a>.</p>
 
645
<p>
 
646
</p>
616
647
<p class="since">Since 2.10</p>
617
648
</div>
618
649
<hr>
619
650
<div class="refsect2" title="g_slist_length ()">
620
651
<a name="g-slist-length"></a><h3>g_slist_length ()</h3>
621
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>               g_slist_length                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);</pre>
 
652
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a>               g_slist_length                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);</pre>
622
653
<p>
623
654
Gets the number of elements in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
624
655
</p>
631
662
count its elements.
632
663
</p>
633
664
</div>
 
665
<p>
 
666
</p>
634
667
<div class="variablelist"><table border="0">
635
668
<col align="left" valign="top">
636
669
<tbody>
650
683
<hr>
651
684
<div class="refsect2" title="g_slist_copy ()">
652
685
<a name="g-slist-copy"></a><h3>g_slist_copy ()</h3>
653
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_copy                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);</pre>
 
686
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_copy                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);</pre>
654
687
<p>
655
688
Copies a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
656
689
</p>
664
697
the actual data isn't.
665
698
</p>
666
699
</div>
 
700
<p>
 
701
</p>
667
702
<div class="variablelist"><table border="0">
668
703
<col align="left" valign="top">
669
704
<tbody>
683
718
<hr>
684
719
<div class="refsect2" title="g_slist_reverse ()">
685
720
<a name="g-slist-reverse"></a><h3>g_slist_reverse ()</h3>
686
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_reverse                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);</pre>
 
721
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_reverse                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);</pre>
687
722
<p>
688
723
Reverses a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.</p>
 
724
<p>
 
725
</p>
689
726
<div class="variablelist"><table border="0">
690
727
<col align="left" valign="top">
691
728
<tbody>
705
742
<hr>
706
743
<div class="refsect2" title="g_slist_insert_sorted_with_data ()">
707
744
<a name="g-slist-insert-sorted-with-data"></a><h3>g_slist_insert_sorted_with_data ()</h3>
708
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_insert_sorted_with_data     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
709
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> data,
710
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="returnvalue">GCompareDataFunc</span></a> func,
711
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 
745
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_insert_sorted_with_data     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
746
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> data,
 
747
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> func,
 
748
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
712
749
<p>
713
750
Inserts a new element into the list, using the given 
714
751
comparison function to determine its position.</p>
 
752
<p>
 
753
</p>
715
754
<div class="variablelist"><table border="0">
716
755
<col align="left" valign="top">
717
756
<tbody>
750
789
<hr>
751
790
<div class="refsect2" title="g_slist_sort ()">
752
791
<a name="g-slist-sort"></a><h3>g_slist_sort ()</h3>
753
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_sort                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
754
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()"><span class="returnvalue">GCompareFunc</span></a> compare_func);</pre>
 
792
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_sort                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
793
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()">GCompareFunc</a> compare_func);</pre>
755
794
<p>
756
795
Sorts a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> using the given comparison function.</p>
 
796
<p>
 
797
</p>
757
798
<div class="variablelist"><table border="0">
758
799
<col align="left" valign="top">
759
800
<tbody>
782
823
<hr>
783
824
<div class="refsect2" title="g_slist_sort_with_data ()">
784
825
<a name="g-slist-sort-with-data"></a><h3>g_slist_sort_with_data ()</h3>
785
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_sort_with_data              (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
786
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()"><span class="returnvalue">GCompareDataFunc</span></a> compare_func,
787
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 
826
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_sort_with_data              (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
827
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareDataFunc" title="GCompareDataFunc ()">GCompareDataFunc</a> compare_func,
 
828
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
788
829
<p>
789
830
Like <a class="link" href="glib-Singly-Linked-Lists.html#g-slist-sort" title="g_slist_sort ()"><code class="function">g_slist_sort()</code></a>, but the sort function accepts a user data argument.</p>
 
831
<p>
 
832
</p>
790
833
<div class="variablelist"><table border="0">
791
834
<col align="left" valign="top">
792
835
<tbody>
816
859
<hr>
817
860
<div class="refsect2" title="g_slist_concat ()">
818
861
<a name="g-slist-concat"></a><h3>g_slist_concat ()</h3>
819
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_concat                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list1,
820
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list2);</pre>
 
862
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_concat                      (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list1,
 
863
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list2);</pre>
821
864
<p>
822
865
Adds the second <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> onto the end of the first <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
823
866
Note that the elements of the second <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> are not copied.
824
867
They are used directly.</p>
 
868
<p>
 
869
</p>
825
870
<div class="variablelist"><table border="0">
826
871
<col align="left" valign="top">
827
872
<tbody>
846
891
<hr>
847
892
<div class="refsect2" title="g_slist_foreach ()">
848
893
<a name="g-slist-foreach"></a><h3>g_slist_foreach ()</h3>
849
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_slist_foreach                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
850
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()"><span class="returnvalue">GFunc</span></a> func,
851
 
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 
894
<pre class="programlisting">void                g_slist_foreach                     (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
895
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GFunc" title="GFunc ()">GFunc</a> func,
 
896
                                                         <a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> user_data);</pre>
852
897
<p>
853
898
Calls a function for each element of a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.</p>
 
899
<p>
 
900
</p>
854
901
<div class="variablelist"><table border="0">
855
902
<col align="left" valign="top">
856
903
<tbody>
875
922
<hr>
876
923
<div class="refsect2" title="g_slist_last ()">
877
924
<a name="g-slist-last"></a><h3>g_slist_last ()</h3>
878
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_last                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list);</pre>
 
925
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_last                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list);</pre>
879
926
<p>
880
927
Gets the last element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
881
928
 
886
933
This function iterates over the whole list.
887
934
</p>
888
935
</div>
 
936
<p>
 
937
</p>
889
938
<div class="variablelist"><table border="0">
890
939
<col align="left" valign="top">
891
940
<tbody>
897
946
<tr>
898
947
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
899
948
<td> the last element in the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>, 
900
 
    or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> has no elements
 
949
    or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> has no elements
901
950
</td>
902
951
</tr>
903
952
</tbody>
909
958
<pre class="programlisting">#define             g_slist_next(slist)</pre>
910
959
<p>
911
960
A convenience macro to get the next element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.</p>
 
961
<p>
 
962
</p>
912
963
<div class="variablelist"><table border="0">
913
964
<col align="left" valign="top">
914
 
<tbody>
915
 
<tr>
 
965
<tbody><tr>
916
966
<td><p><span class="term"><em class="parameter"><code>slist</code></em> :</span></p></td>
917
967
<td> an element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.
918
968
</td>
919
 
</tr>
920
 
<tr>
921
 
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
922
 
<td> the next element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if there are no more elements.
923
 
</td>
924
 
</tr>
925
 
</tbody>
 
969
</tr></tbody>
926
970
</table></div>
927
971
</div>
928
972
<hr>
929
973
<div class="refsect2" title="g_slist_nth ()">
930
974
<a name="g-slist-nth"></a><h3>g_slist_nth ()</h3>
931
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_nth                         (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
932
 
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> n);</pre>
 
975
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_nth                         (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
976
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n);</pre>
933
977
<p>
934
978
Gets the element at the given position in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>.</p>
 
979
<p>
 
980
</p>
935
981
<div class="variablelist"><table border="0">
936
982
<col align="left" valign="top">
937
983
<tbody>
947
993
</tr>
948
994
<tr>
949
995
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
950
 
<td> the element, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the position is off 
 
996
<td> the element, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if the position is off 
951
997
    the end of the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>
952
998
</td>
953
999
</tr>
957
1003
<hr>
958
1004
<div class="refsect2" title="g_slist_nth_data ()">
959
1005
<a name="g-slist-nth-data"></a><h3>g_slist_nth_data ()</h3>
960
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a>            g_slist_nth_data                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
961
 
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a> n);</pre>
 
1006
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a>            g_slist_nth_data                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
1007
                                                         <a class="link" href="glib-Basic-Types.html#guint" title="guint">guint</a> n);</pre>
962
1008
<p>
963
1009
Gets the data of the element at the given position.</p>
 
1010
<p>
 
1011
</p>
964
1012
<div class="variablelist"><table border="0">
965
1013
<col align="left" valign="top">
966
1014
<tbody>
976
1024
</tr>
977
1025
<tr>
978
1026
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
979
 
<td> the element's data, or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if the position 
 
1027
<td> the element's data, or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if the position 
980
1028
    is off the end of the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>
981
1029
</td>
982
1030
</tr>
986
1034
<hr>
987
1035
<div class="refsect2" title="g_slist_find ()">
988
1036
<a name="g-slist-find"></a><h3>g_slist_find ()</h3>
989
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_find                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
990
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);</pre>
 
1037
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_find                        (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
1038
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);</pre>
991
1039
<p>
992
1040
Finds the element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> which 
993
1041
contains the given data.</p>
 
1042
<p>
 
1043
</p>
994
1044
<div class="variablelist"><table border="0">
995
1045
<col align="left" valign="top">
996
1046
<tbody>
1007
1057
<tr>
1008
1058
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1009
1059
<td> the found <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> element, 
1010
 
    or <a class="link" href="glib-Standard-Macros.html#NULL:CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not found
 
1060
    or <a class="link" href="glib-Standard-Macros.html#NULL--CAPS" title="NULL"><code class="literal">NULL</code></a> if it is not found
1011
1061
</td>
1012
1062
</tr>
1013
1063
</tbody>
1016
1066
<hr>
1017
1067
<div class="refsect2" title="g_slist_find_custom ()">
1018
1068
<a name="g-slist-find-custom"></a><h3>g_slist_find_custom ()</h3>
1019
 
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a>*             g_slist_find_custom                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
1020
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data,
1021
 
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()"><span class="returnvalue">GCompareFunc</span></a> func);</pre>
 
1069
<pre class="programlisting"><a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a>*             g_slist_find_custom                 (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
1070
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data,
 
1071
                                                         <a class="link" href="glib-Doubly-Linked-Lists.html#GCompareFunc" title="GCompareFunc ()">GCompareFunc</a> func);</pre>
1022
1072
<p>
1023
1073
Finds an element in a <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a>, using a supplied function to 
1024
1074
find the desired element. It iterates over the list, calling 
1026
1076
element is found. The function takes two <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="type">gconstpointer</span></a> arguments, 
1027
1077
the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> element's data as the first argument and the 
1028
1078
given user data.</p>
 
1079
<p>
 
1080
</p>
1029
1081
<div class="variablelist"><table border="0">
1030
1082
<col align="left" valign="top">
1031
1083
<tbody>
1047
1099
</tr>
1048
1100
<tr>
1049
1101
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1050
 
<td> the found <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> 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
 
1102
<td> the found <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> 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
1051
1103
</td>
1052
1104
</tr>
1053
1105
</tbody>
1056
1108
<hr>
1057
1109
<div class="refsect2" title="g_slist_position ()">
1058
1110
<a name="g-slist-position"></a><h3>g_slist_position ()</h3>
1059
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_slist_position                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
1060
 
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *llink);</pre>
 
1111
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_slist_position                    (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
1112
                                                         <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *llink);</pre>
1061
1113
<p>
1062
1114
Gets the position of the given element 
1063
1115
in the <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> (starting from 0).</p>
 
1116
<p>
 
1117
</p>
1064
1118
<div class="variablelist"><table border="0">
1065
1119
<col align="left" valign="top">
1066
1120
<tbody>
1086
1140
<hr>
1087
1141
<div class="refsect2" title="g_slist_index ()">
1088
1142
<a name="g-slist-index"></a><h3>g_slist_index ()</h3>
1089
 
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="returnvalue">gint</span></a>                g_slist_index                       (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="returnvalue">GSList</span></a> *list,
1090
 
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer"><span class="returnvalue">gconstpointer</span></a> data);</pre>
 
1143
<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gint" title="gint">gint</a>                g_slist_index                       (<a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList">GSList</a> *list,
 
1144
                                                         <a class="link" href="glib-Basic-Types.html#gconstpointer" title="gconstpointer">gconstpointer</a> data);</pre>
1091
1145
<p>
1092
1146
Gets the position of the element containing 
1093
1147
the given data (starting from 0).</p>
 
1148
<p>
 
1149
</p>
1094
1150
<div class="variablelist"><table border="0">
1095
1151
<col align="left" valign="top">
1096
1152
<tbody>
1116
1172
<hr>
1117
1173
<div class="refsect2" title="g_slist_push_allocator ()">
1118
1174
<a name="g-slist-push-allocator"></a><h3>g_slist_push_allocator ()</h3>
1119
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_slist_push_allocator              (<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer"><span class="returnvalue">gpointer</span></a> dummy);</pre>
 
1175
<pre class="programlisting">void                g_slist_push_allocator              (<a class="link" href="glib-Basic-Types.html#gpointer" title="gpointer">gpointer</a> dummy);</pre>
1120
1176
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1121
1177
<h3 class="title">Warning</h3>
1122
1178
<p><code class="literal">g_slist_push_allocator</code> has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> has been converted
1130
1186
<p>
1131
1187
Note that this function is not available if GLib has been compiled
1132
1188
with <code class="option">--disable-mem-pools</code></p>
 
1189
<p>
 
1190
</p>
1133
1191
<div class="variablelist"><table border="0">
1134
1192
<col align="left" valign="top">
1135
1193
<tbody><tr>
1142
1200
<hr>
1143
1201
<div class="refsect2" title="g_slist_pop_allocator ()">
1144
1202
<a name="g-slist-pop-allocator"></a><h3>g_slist_pop_allocator ()</h3>
1145
 
<pre class="programlisting"><span class="returnvalue">void</span>                g_slist_pop_allocator               (void);</pre>
 
1203
<pre class="programlisting">void                g_slist_pop_allocator               (void);</pre>
1146
1204
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1147
1205
<h3 class="title">Warning</h3>
1148
1206
<p><code class="literal">g_slist_pop_allocator</code> has been deprecated since version 2.10 and should not be used in newly-written code. It does nothing, since <a class="link" href="glib-Singly-Linked-Lists.html#GSList" title="GSList"><span class="type">GSList</span></a> has been converted
1156
1214
<p>
1157
1215
Note that this function is not available if GLib has been compiled
1158
1216
with <code class="option">--disable-mem-pools</code></p>
 
1217
<p>
 
1218
</p>
1159
1219
</div>
1160
1220
</div>
1161
1221
</div>
1162
1222
<div class="footer">
1163
1223
<hr>
1164
 
          Generated by GTK-Doc V1.13</div>
 
1224
          Generated by GTK-Doc V1.11</div>
1165
1225
</body>
1166
 
</html>
 
 
b'\\ No newline at end of file'
 
1226
</html>