← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/glib2.0/gutsy

« 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: 2007-07-23 10:03:37 UTC
  • mfrom: (1.2.26 upstream)
  • Revision ID: james.westby@ubuntu.com-20070723100337-s4t314uesugvc8fr
Tags: 2.13.7-1ubuntu1
https://launchpad.net/bugs/116870
* Sync with Debian and new upstream version:
  - The memory corruption warning from the slice allocator that
    occurred when threads were initialized after the slice allocator
    has been removed, as the slice allocator now works fine
    in this scenario (LP: #116870)
  - New functions g_once_init_enter() and g_once_init_leave() make
    it easier to write threadsafe one-time initialization functions 
  - Bugs fixed:
    454473 Simple XML Subset Parser terminates on invalid XML
    445813 g_module_open error, add file name
    453796 errno gets clobbered by g_filename_display_name
    341988 don't use "-c" with msgfmt in Makefile.in.in
    447048 Please produce slightly more output during long tests
    454785 GModule documentation lists same block of code twice.
    454786 GModule documentation lists same paragraph twice.
    383155 small docs quirks in gobject/closure API documentation
    65041  _get_type() functions aren't thread safe
* debian/control.in:
  - the package is maintained by the Ubuntu Desktop Team 
* debian/patches/series:
  - use 01_gettext-desktopfiles.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/glib/html/glib-Singly-Linked-Lists.html
35
35
<th width="100%" align="center">GLib Reference Manual</th>
36
36
<td><a accesskey="n" href="glib-Double-ended-Queues.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
37
37
</tr>
38
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3208586" class="shortcut">Top</a>
 
38
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3032797" class="shortcut">Top</a>
39
39
                  &#160;|&#160;
40
 
                  <a href="#id3209495" class="shortcut">Description</a></nobr></td></tr>
 
40
                  <a href="#id3033706" class="shortcut">Description</a></nobr></td></tr>
41
41
</table>
42
42
<div class="refentry" lang="en">
43
43
<a name="glib-Singly-Linked-Lists"></a><div class="titlepage"></div>
44
44
<div class="refnamediv"><table width="100%"><tr>
45
45
<td valign="top">
46
46
<h2>
47
 
<a name="id3208586"></a><span class="refentrytitle">Singly-Linked Lists</span>
 
47
<a name="id3032797"></a><span class="refentrytitle">Singly-Linked Lists</span>
48
48
</h2>
49
49
<p>Singly-Linked Lists &#8212; linked lists containing integer values or pointers to data, limited to
50
50
iterating over the list in one direction.</p>
126
126
</pre>
127
127
</div>
128
128
<div class="refsect1" lang="en">
129
 
<a name="id3209495"></a><h2>Description</h2>
 
129
<a name="id3033706"></a><h2>Description</h2>
130
130
<p>
131
131
The <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> structure and its associated functions provide a standard
132
132
singly-linked list data structure.
182
182
</p>
183
183
</div>
184
184
<div class="refsect1" lang="en">
185
 
<a name="id3209796"></a><h2>Details</h2>
 
185
<a name="id3034007"></a><h2>Details</h2>
186
186
<div class="refsect2" lang="en">
187
 
<a name="id3209807"></a><h3>
 
187
<a name="id3034018"></a><h3>
188
188
<a name="GSList"></a>GSList</h3>
189
 
<a class="indexterm" name="id3209819"></a><pre class="programlisting">typedef struct {
 
189
<a class="indexterm" name="id3034030"></a><pre class="programlisting">typedef struct {
190
190
  gpointer data;
191
191
  GSList *next;
192
192
} GSList;
215
215
</div>
216
216
<hr>
217
217
<div class="refsect2" lang="en">
218
 
<a name="id3209899"></a><h3>
 
218
<a name="id3034110"></a><h3>
219
219
<a name="g-slist-alloc"></a>g_slist_alloc ()</h3>
220
 
<a class="indexterm" name="id3209912"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_alloc                       (void);</pre>
 
220
<a class="indexterm" name="id3034123"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_alloc                       (void);</pre>
221
221
<p>
222
222
Allocates space for one <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element.
223
223
It is called by the <a href="glib-Singly-Linked-Lists.html#g-slist-append"><code class="function">g_slist_append()</code></a>, <a href="glib-Singly-Linked-Lists.html#g-slist-prepend"><code class="function">g_slist_prepend()</code></a>, <a href="glib-Singly-Linked-Lists.html#g-slist-insert"><code class="function">g_slist_insert()</code></a> and
236
236
</div>
237
237
<hr>
238
238
<div class="refsect2" lang="en">
239
 
<a name="id3210009"></a><h3>
 
239
<a name="id3034220"></a><h3>
240
240
<a name="g-slist-append"></a>g_slist_append ()</h3>
241
 
<a class="indexterm" name="id3210022"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_append                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
241
<a class="indexterm" name="id3034233"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_append                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
242
242
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
243
243
<p>
244
244
Adds a new element on to the end of the list.
296
296
</div>
297
297
<hr>
298
298
<div class="refsect2" lang="en">
299
 
<a name="id3210160"></a><h3>
 
299
<a name="id3034371"></a><h3>
300
300
<a name="g-slist-prepend"></a>g_slist_prepend ()</h3>
301
 
<a class="indexterm" name="id3210173"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_prepend                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
301
<a class="indexterm" name="id3034384"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_prepend                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
302
302
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
303
303
<p>
304
304
Adds a new element on to the start of the list.
341
341
</div>
342
342
<hr>
343
343
<div class="refsect2" lang="en">
344
 
<a name="id3210286"></a><h3>
 
344
<a name="id3034497"></a><h3>
345
345
<a name="g-slist-insert"></a>g_slist_insert ()</h3>
346
 
<a class="indexterm" name="id3210299"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
346
<a class="indexterm" name="id3034510"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
347
347
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> data,
348
348
                                                         <a href="glib-Basic-Types.html#gint">gint</a> position);</pre>
349
349
<p>
381
381
</div>
382
382
<hr>
383
383
<div class="refsect2" lang="en">
384
 
<a name="id3210418"></a><h3>
 
384
<a name="id3034629"></a><h3>
385
385
<a name="g-slist-insert-before"></a>g_slist_insert_before ()</h3>
386
 
<a class="indexterm" name="id3210431"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert_before               (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *slist,
 
386
<a class="indexterm" name="id3034642"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert_before               (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *slist,
387
387
                                                         <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *sibling,
388
388
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> data);</pre>
389
389
<p>
419
419
</div>
420
420
<hr>
421
421
<div class="refsect2" lang="en">
422
 
<a name="id3210559"></a><h3>
 
422
<a name="id3034770"></a><h3>
423
423
<a name="g-slist-insert-sorted"></a>g_slist_insert_sorted ()</h3>
424
 
<a class="indexterm" name="id3210572"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert_sorted               (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
424
<a class="indexterm" name="id3034783"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert_sorted               (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
425
425
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> data,
426
426
                                                         <a href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> func);</pre>
427
427
<p>
460
460
</div>
461
461
<hr>
462
462
<div class="refsect2" lang="en">
463
 
<a name="id3210693"></a><h3>
 
463
<a name="id3034904"></a><h3>
464
464
<a name="g-slist-remove"></a>g_slist_remove ()</h3>
465
 
<a class="indexterm" name="id3210705"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_remove                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
465
<a class="indexterm" name="id3034916"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_remove                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
466
466
                                                         <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
467
467
<p>
468
468
Removes an element from a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
494
494
</div>
495
495
<hr>
496
496
<div class="refsect2" lang="en">
497
 
<a name="id3210819"></a><h3>
 
497
<a name="id3035030"></a><h3>
498
498
<a name="g-slist-remove-link"></a>g_slist_remove_link ()</h3>
499
 
<a class="indexterm" name="id3210832"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_remove_link                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
499
<a class="indexterm" name="id3035043"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_remove_link                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
500
500
                                                         <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *link_);</pre>
501
501
<p>
502
502
Removes an element from a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>, without freeing the element.
528
528
</div>
529
529
<hr>
530
530
<div class="refsect2" lang="en">
531
 
<a name="id3210955"></a><h3>
 
531
<a name="id3035166"></a><h3>
532
532
<a name="g-slist-delete-link"></a>g_slist_delete_link ()</h3>
533
 
<a class="indexterm" name="id3210968"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_delete_link                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
533
<a class="indexterm" name="id3035179"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_delete_link                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
534
534
                                                         <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *link_);</pre>
535
535
<p>
536
536
Deletes a node of <em class="parameter"><code>list</code></em>. Returns the new list head.
560
560
</div>
561
561
<hr>
562
562
<div class="refsect2" lang="en">
563
 
<a name="id3211066"></a><h3>
 
563
<a name="id3035277"></a><h3>
564
564
<a name="g-slist-remove-all"></a>g_slist_remove_all ()</h3>
565
 
<a class="indexterm" name="id3211079"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_remove_all                  (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
565
<a class="indexterm" name="id3035290"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_remove_all                  (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
566
566
                                                         <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
567
567
<p>
568
568
Removes all list nodes with data equal to <em class="parameter"><code>data</code></em>. Returns the new
594
594
</div>
595
595
<hr>
596
596
<div class="refsect2" lang="en">
597
 
<a name="id3211190"></a><h3>
 
597
<a name="id3035401"></a><h3>
598
598
<a name="g-slist-free"></a>g_slist_free ()</h3>
599
 
<a class="indexterm" name="id3211203"></a><pre class="programlisting">void                g_slist_free                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
 
599
<a class="indexterm" name="id3035414"></a><pre class="programlisting">void                g_slist_free                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
600
600
<p>
601
601
Frees all of the memory used by a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
602
602
The freed elements are returned to the slice allocator.
614
614
</div>
615
615
<hr>
616
616
<div class="refsect2" lang="en">
617
 
<a name="id3211267"></a><h3>
 
617
<a name="id3035478"></a><h3>
618
618
<a name="g-slist-free-1"></a>g_slist_free_1 ()</h3>
619
 
<a class="indexterm" name="id3211279"></a><pre class="programlisting">void                g_slist_free_1                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
 
619
<a class="indexterm" name="id3035490"></a><pre class="programlisting">void                g_slist_free_1                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
620
620
<p>
621
621
Frees one <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> element.
622
622
It is usually used after <a href="glib-Singly-Linked-Lists.html#g-slist-remove-link"><code class="function">g_slist_remove_link()</code></a>.
634
634
</div>
635
635
<hr>
636
636
<div class="refsect2" lang="en">
637
 
<a name="id3211353"></a><h3>
 
637
<a name="id3035564"></a><h3>
638
638
<a name="g-slist-free1"></a>g_slist_free1</h3>
639
 
<a class="indexterm" name="id3211368"></a><pre class="programlisting">#define             g_slist_free1</pre>
 
639
<a class="indexterm" name="id3035579"></a><pre class="programlisting">#define             g_slist_free1</pre>
640
640
<p>
641
641
A macro which does the same as <a href="glib-Singly-Linked-Lists.html#g-slist-free-1"><code class="function">g_slist_free_1()</code></a>.
642
642
</p>
647
647
</div>
648
648
<hr>
649
649
<div class="refsect2" lang="en">
650
 
<a name="id3211402"></a><h3>
 
650
<a name="id3035612"></a><h3>
651
651
<a name="g-slist-length"></a>g_slist_length ()</h3>
652
 
<a class="indexterm" name="id3211414"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>               g_slist_length                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
 
652
<a class="indexterm" name="id3035625"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>               g_slist_length                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
653
653
<p>
654
654
Gets the number of elements in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
655
655
</p>
673
673
</div>
674
674
<hr>
675
675
<div class="refsect2" lang="en">
676
 
<a name="id3211496"></a><h3>
 
676
<a name="id3035706"></a><h3>
677
677
<a name="g-slist-copy"></a>g_slist_copy ()</h3>
678
 
<a class="indexterm" name="id3211508"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_copy                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
 
678
<a class="indexterm" name="id3035719"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_copy                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
679
679
<p>
680
680
Copies a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
681
681
</p>
703
703
</div>
704
704
<hr>
705
705
<div class="refsect2" lang="en">
706
 
<a name="id3211592"></a><h3>
 
706
<a name="id3035803"></a><h3>
707
707
<a name="g-slist-reverse"></a>g_slist_reverse ()</h3>
708
 
<a class="indexterm" name="id3211605"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_reverse                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
 
708
<a class="indexterm" name="id3035816"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_reverse                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
709
709
<p>
710
710
Reverses a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
711
711
</p>
729
729
</div>
730
730
<hr>
731
731
<div class="refsect2" lang="en">
732
 
<a name="id3211685"></a><h3>
 
732
<a name="id3035896"></a><h3>
733
733
<a name="g-slist-insert-sorted-with-data"></a>g_slist_insert_sorted_with_data ()</h3>
734
 
<a class="indexterm" name="id3211698"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert_sorted_with_data     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
734
<a class="indexterm" name="id3035909"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_insert_sorted_with_data     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
735
735
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> data,
736
736
                                                         <a href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> func,
737
737
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
777
777
</div>
778
778
<hr>
779
779
<div class="refsect2" lang="en">
780
 
<a name="id3211847"></a><h3>
 
780
<a name="id3036058"></a><h3>
781
781
<a name="g-slist-sort"></a>g_slist_sort ()</h3>
782
 
<a class="indexterm" name="id3211860"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_sort                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
782
<a class="indexterm" name="id3036071"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_sort                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
783
783
                                                         <a href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> compare_func);</pre>
784
784
<p>
785
785
Sorts a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> using the given comparison function.
813
813
</div>
814
814
<hr>
815
815
<div class="refsect2" lang="en">
816
 
<a name="id3211984"></a><h3>
 
816
<a name="id3036195"></a><h3>
817
817
<a name="g-slist-sort-with-data"></a>g_slist_sort_with_data ()</h3>
818
 
<a class="indexterm" name="id3211997"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_sort_with_data              (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
818
<a class="indexterm" name="id3036208"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_sort_with_data              (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
819
819
                                                         <a href="glib-Doubly-Linked-Lists.html#GCompareDataFunc">GCompareDataFunc</a> compare_func,
820
820
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
821
821
<p>
851
851
</div>
852
852
<hr>
853
853
<div class="refsect2" lang="en">
854
 
<a name="id3212118"></a><h3>
 
854
<a name="id3036329"></a><h3>
855
855
<a name="g-slist-concat"></a>g_slist_concat ()</h3>
856
 
<a class="indexterm" name="id3212130"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_concat                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list1,
 
856
<a class="indexterm" name="id3036341"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_concat                      (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list1,
857
857
                                                         <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list2);</pre>
858
858
<p>
859
859
Adds the second <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> onto the end of the first <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
885
885
</div>
886
886
<hr>
887
887
<div class="refsect2" lang="en">
888
 
<a name="id3212266"></a><h3>
 
888
<a name="id3036477"></a><h3>
889
889
<a name="g-slist-foreach"></a>g_slist_foreach ()</h3>
890
 
<a class="indexterm" name="id3212279"></a><pre class="programlisting">void                g_slist_foreach                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
890
<a class="indexterm" name="id3036490"></a><pre class="programlisting">void                g_slist_foreach                     (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
891
891
                                                         <a href="glib-Doubly-Linked-Lists.html#GFunc">GFunc</a> func,
892
892
                                                         <a href="glib-Basic-Types.html#gpointer">gpointer</a> user_data);</pre>
893
893
<p>
918
918
</div>
919
919
<hr>
920
920
<div class="refsect2" lang="en">
921
 
<a name="id3212386"></a><h3>
 
921
<a name="id3036597"></a><h3>
922
922
<a name="g-slist-last"></a>g_slist_last ()</h3>
923
 
<a class="indexterm" name="id3212398"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_last                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
 
923
<a class="indexterm" name="id3036609"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_last                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list);</pre>
924
924
<p>
925
925
Gets the last element in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
926
926
</p>
945
945
</div>
946
946
<hr>
947
947
<div class="refsect2" lang="en">
948
 
<a name="id3212497"></a><h3>
 
948
<a name="id3036708"></a><h3>
949
949
<a name="g-slist-next"></a>g_slist_next()</h3>
950
 
<a class="indexterm" name="id3212510"></a><pre class="programlisting">#define             g_slist_next(slist)</pre>
 
950
<a class="indexterm" name="id3036721"></a><pre class="programlisting">#define             g_slist_next(slist)</pre>
951
951
<p>
952
952
A convenience macro to gets the next element in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
953
953
</p>
971
971
</div>
972
972
<hr>
973
973
<div class="refsect2" lang="en">
974
 
<a name="id3212581"></a><h3>
 
974
<a name="id3036792"></a><h3>
975
975
<a name="g-slist-nth"></a>g_slist_nth ()</h3>
976
 
<a class="indexterm" name="id3212593"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_nth                         (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
976
<a class="indexterm" name="id3036804"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_nth                         (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
977
977
                                                         <a href="glib-Basic-Types.html#guint">guint</a> n);</pre>
978
978
<p>
979
979
Gets the element at the given position in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a>.
1003
1003
</div>
1004
1004
<hr>
1005
1005
<div class="refsect2" lang="en">
1006
 
<a name="id3212707"></a><h3>
 
1006
<a name="id3036918"></a><h3>
1007
1007
<a name="g-slist-nth-data"></a>g_slist_nth_data ()</h3>
1008
 
<a class="indexterm" name="id3212720"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>            g_slist_nth_data                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
1008
<a class="indexterm" name="id3036931"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gpointer">gpointer</a>            g_slist_nth_data                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
1009
1009
                                                         <a href="glib-Basic-Types.html#guint">guint</a> n);</pre>
1010
1010
<p>
1011
1011
Gets the data of the element at the given position.
1036
1036
</div>
1037
1037
<hr>
1038
1038
<div class="refsect2" lang="en">
1039
 
<a name="id3212826"></a><h3>
 
1039
<a name="id3037037"></a><h3>
1040
1040
<a name="g-slist-find"></a>g_slist_find ()</h3>
1041
 
<a class="indexterm" name="id3212839"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_find                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
1041
<a class="indexterm" name="id3037050"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_find                        (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
1042
1042
                                                         <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
1043
1043
<p>
1044
1044
Finds the element in a <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> which contains the given data.
1068
1068
</div>
1069
1069
<hr>
1070
1070
<div class="refsect2" lang="en">
1071
 
<a name="id3212953"></a><h3>
 
1071
<a name="id3037164"></a><h3>
1072
1072
<a name="g-slist-find-custom"></a>g_slist_find_custom ()</h3>
1073
 
<a class="indexterm" name="id3212966"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_find_custom                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
1073
<a class="indexterm" name="id3037177"></a><pre class="programlisting"><a href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*             g_slist_find_custom                 (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
1074
1074
                                                         <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data,
1075
1075
                                                         <a href="glib-Doubly-Linked-Lists.html#GCompareFunc">GCompareFunc</a> func);</pre>
1076
1076
<p>
1112
1112
</div>
1113
1113
<hr>
1114
1114
<div class="refsect2" lang="en">
1115
 
<a name="id3213124"></a><h3>
 
1115
<a name="id3037335"></a><h3>
1116
1116
<a name="g-slist-position"></a>g_slist_position ()</h3>
1117
 
<a class="indexterm" name="id3213137"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>                g_slist_position                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
1117
<a class="indexterm" name="id3037348"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>                g_slist_position                    (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
1118
1118
                                                         <a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *llink);</pre>
1119
1119
<p>
1120
1120
Gets the position of the given element in the <a href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> (starting from 0).
1145
1145
</div>
1146
1146
<hr>
1147
1147
<div class="refsect2" lang="en">
1148
 
<a name="id3213248"></a><h3>
 
1148
<a name="id3037459"></a><h3>
1149
1149
<a name="g-slist-index"></a>g_slist_index ()</h3>
1150
 
<a class="indexterm" name="id3213261"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>                g_slist_index                       (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
 
1150
<a class="indexterm" name="id3037472"></a><pre class="programlisting"><a href="glib-Basic-Types.html#gint">gint</a>                g_slist_index                       (<a href="glib-Singly-Linked-Lists.html#GSList">GSList</a> *list,
1151
1151
                                                         <a href="glib-Basic-Types.html#gconstpointer">gconstpointer</a> data);</pre>
1152
1152
<p>
1153
1153
Gets the position of the element containing the given data (starting from 0).
1178
1178
</div>
1179
1179
<hr>
1180
1180
<div class="refsect2" lang="en">
1181
 
<a name="id3213350"></a><h3>
 
1181
<a name="id3037561"></a><h3>
1182
1182
<a name="g-slist-push-allocator"></a>g_slist_push_allocator ()</h3>
1183
 
<a class="indexterm" name="id3213366"></a><pre class="programlisting">void                g_slist_push_allocator              (<a href="glib-Basic-Types.html#gpointer">gpointer</a> dummy);</pre>
 
1183
<a class="indexterm" name="id3037577"></a><pre class="programlisting">void                g_slist_push_allocator              (<a href="glib-Basic-Types.html#gpointer">gpointer</a> dummy);</pre>
1184
1184
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1185
1185
<h3 class="title">Warning</h3>
1186
1186
<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 href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> has been
1205
1205
</div>
1206
1206
<hr>
1207
1207
<div class="refsect2" lang="en">
1208
 
<a name="id3213485"></a><h3>
 
1208
<a name="id3037696"></a><h3>
1209
1209
<a name="g-slist-pop-allocator"></a>g_slist_pop_allocator ()</h3>
1210
 
<a class="indexterm" name="id3213500"></a><pre class="programlisting">void                g_slist_pop_allocator               (void);</pre>
 
1210
<a class="indexterm" name="id3037711"></a><pre class="programlisting">void                g_slist_pop_allocator               (void);</pre>
1211
1211
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1212
1212
<h3 class="title">Warning</h3>
1213
1213
<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 href="glib-Singly-Linked-Lists.html#GSList"><span class="type">GSList</span></a> has been