1 gslist.h

     1 /* GLIB - Library of useful routines for C programming

     2  * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald

     3  * Portions copyright (c) 2006 Nokia Corporation.  All rights reserved.

     4  *

     5  * This library is free software; you can redistribute it and/or

     6  * modify it under the terms of the GNU Lesser General Public

     7  * License as published by the Free Software Foundation; either

     8  * version 2 of the License, or (at your option) any later version.

     9  *

    10  * This library is distributed in the hope that it will be useful,

    11  * but WITHOUT ANY WARRANTY; without even the implied warranty of

    12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU

    13  * Lesser General Public License for more details.

    14  *

    15  * You should have received a copy of the GNU Lesser General Public

    16  * License along with this library; if not, write to the

    17  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,

    18  * Boston, MA 02111-1307, USA.

    19  */

    20 

    21 /*

    22  * Modified by the GLib Team and others 1997-2000.  See the AUTHORS

    23  * file for a list of people on the GLib Team.  See the ChangeLog

    24  * files for a list of changes.  These files are distributed with

    25  * GLib at ftp://ftp.gtk.org/pub/gtk/. 

    26  */

    27 

    28 #ifndef __G_SLIST_H__

    29 #define __G_SLIST_H__

    30 

    31 #include <_ansi.h>

    32 #include <glib/gmem.h>

    33 

    34 G_BEGIN_DECLS

    35 

    36 typedef struct _GSList GSList;

    37 

    38 struct _GSList

    39 {

    40   gpointer data;

    41   GSList *next;

    42 };

    43 

    44 /* Singly linked lists

    45  */

    46 IMPORT_C GSList*  g_slist_alloc                   (void) G_GNUC_WARN_UNUSED_RESULT;

    47 IMPORT_C void     g_slist_free           (GSList           *list);

    48 IMPORT_C void     g_slist_free_1         (GSList           *list);

    49 #define	 g_slist_free1		         g_slist_free_1

    50 IMPORT_C GSList*  g_slist_append         (GSList           *list,

    51 					  gpointer          data) G_GNUC_WARN_UNUSED_RESULT;

    52 IMPORT_C GSList*  g_slist_prepend        (GSList           *list,

    53 					  gpointer          data) G_GNUC_WARN_UNUSED_RESULT;

    54 IMPORT_C GSList*  g_slist_insert                  (GSList           *list,

    55 					  gpointer          data,

    56 					  gint              position) G_GNUC_WARN_UNUSED_RESULT;

    57 IMPORT_C GSList*  g_slist_insert_sorted           (GSList           *list,

    58 					  gpointer          data,

    59 					  GCompareFunc      func) G_GNUC_WARN_UNUSED_RESULT;

    60 IMPORT_C GSList*  g_slist_insert_sorted_with_data (GSList           *list,

    61 					  gpointer          data,

    62 					  GCompareDataFunc  func,

    63 					  gpointer          user_data) G_GNUC_WARN_UNUSED_RESULT;

    64 IMPORT_C GSList*  g_slist_insert_before           (GSList           *slist,

    65 					  GSList           *sibling,

    66 					  gpointer          data) G_GNUC_WARN_UNUSED_RESULT;

    67 IMPORT_C GSList*  g_slist_concat         (GSList           *list1,

    68 					  GSList           *list2) G_GNUC_WARN_UNUSED_RESULT;

    69 IMPORT_C GSList*  g_slist_remove         (GSList           *list,

    70 					  gconstpointer     data) G_GNUC_WARN_UNUSED_RESULT;

    71 IMPORT_C GSList*  g_slist_remove_all     (GSList           *list,

    72 					  gconstpointer     data) G_GNUC_WARN_UNUSED_RESULT;

    73 IMPORT_C GSList*  g_slist_remove_link    (GSList           *list,

    74 					  GSList           *link_) G_GNUC_WARN_UNUSED_RESULT;

    75 IMPORT_C GSList*  g_slist_delete_link    (GSList           *list,

    76 					  GSList           *link_) G_GNUC_WARN_UNUSED_RESULT;

    77 IMPORT_C GSList*  g_slist_reverse                 (GSList           *list) G_GNUC_WARN_UNUSED_RESULT;

    78 IMPORT_C GSList*  g_slist_copy                    (GSList           *list) G_GNUC_WARN_UNUSED_RESULT;

    79 IMPORT_C GSList*  g_slist_nth            (GSList           *list,

    80 					  guint             n);

    81 IMPORT_C GSList*  g_slist_find           (GSList           *list,

    82 					  gconstpointer     data);

    83 IMPORT_C GSList*  g_slist_find_custom    (GSList           *list,

    84 					  gconstpointer     data,

    85 					  GCompareFunc      func);

    86 IMPORT_C gint     g_slist_position       (GSList           *list,

    87 					  GSList           *llink);

    88 IMPORT_C gint     g_slist_index          (GSList           *list,

    89 					  gconstpointer     data);

    90 IMPORT_C GSList*  g_slist_last           (GSList           *list);

    91 IMPORT_C guint    g_slist_length         (GSList           *list);

    92 IMPORT_C void     g_slist_foreach        (GSList           *list,

    93 					  GFunc             func,

    94 					  gpointer          user_data);

    95 IMPORT_C GSList*  g_slist_sort           (GSList           *list,

    96 					  GCompareFunc      compare_func) G_GNUC_WARN_UNUSED_RESULT;

    97 IMPORT_C GSList*  g_slist_sort_with_data (GSList           *list,

    98 					  GCompareDataFunc  compare_func,

    99 					  gpointer          user_data) G_GNUC_WARN_UNUSED_RESULT;

   100 IMPORT_C gpointer g_slist_nth_data       (GSList           *list,

   101 					  guint             n);

   102 

   103 #define  g_slist_next(slist)	         ((slist) ? (((GSList *)(slist))->next) : NULL)

   104 

   105 #ifndef G_DISABLE_DEPRECATED

   106 IMPORT_C void     g_slist_push_allocator          (gpointer	   dummy);

   107 IMPORT_C void     g_slist_pop_allocator           (void);

   108 #endif

   109 G_END_DECLS

   110 

   111 #endif /* __G_SLIST_H__ */

   112