1 /* GLIB - Library of useful routines for C programming
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * SPDX-License-Identifier: LGPL-2.1-or-later
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, see <http://www.gnu.org/licenses/>.
21 * Modified by the GLib Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GLib Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GLib at ftp://ftp.gtk.org/pub/gtk/.
30 #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
31 #error "Only <glib.h> can be included directly."
34 #include <glib/gmem.h>
35 #include <glib/gnode.h>
39 typedef struct _GSList GSList;
47 /* Singly linked lists
50 GSList* g_slist_alloc (void) G_GNUC_WARN_UNUSED_RESULT;
52 void g_slist_free (GSList *list);
54 void g_slist_free_1 (GSList *list);
55 #define g_slist_free1 g_slist_free_1
57 void g_slist_free_full (GSList *list,
58 GDestroyNotify free_func);
60 GSList* g_slist_append (GSList *list,
61 gpointer data) G_GNUC_WARN_UNUSED_RESULT;
63 GSList* g_slist_prepend (GSList *list,
64 gpointer data) G_GNUC_WARN_UNUSED_RESULT;
66 GSList* g_slist_insert (GSList *list,
68 gint position) G_GNUC_WARN_UNUSED_RESULT;
70 GSList* g_slist_insert_sorted (GSList *list,
72 GCompareFunc func) G_GNUC_WARN_UNUSED_RESULT;
74 GSList* g_slist_insert_sorted_with_data (GSList *list,
76 GCompareDataFunc func,
77 gpointer user_data) G_GNUC_WARN_UNUSED_RESULT;
79 GSList* g_slist_insert_before (GSList *slist,
81 gpointer data) G_GNUC_WARN_UNUSED_RESULT;
83 GSList* g_slist_concat (GSList *list1,
84 GSList *list2) G_GNUC_WARN_UNUSED_RESULT;
86 GSList* g_slist_remove (GSList *list,
87 gconstpointer data) G_GNUC_WARN_UNUSED_RESULT;
89 GSList* g_slist_remove_all (GSList *list,
90 gconstpointer data) G_GNUC_WARN_UNUSED_RESULT;
92 GSList* g_slist_remove_link (GSList *list,
93 GSList *link_) G_GNUC_WARN_UNUSED_RESULT;
95 GSList* g_slist_delete_link (GSList *list,
96 GSList *link_) G_GNUC_WARN_UNUSED_RESULT;
98 GSList* g_slist_reverse (GSList *list) G_GNUC_WARN_UNUSED_RESULT;
100 GSList* g_slist_copy (GSList *list) G_GNUC_WARN_UNUSED_RESULT;
102 GLIB_AVAILABLE_IN_2_34
103 GSList* g_slist_copy_deep (GSList *list,
105 gpointer user_data) G_GNUC_WARN_UNUSED_RESULT;
106 GLIB_AVAILABLE_IN_ALL
107 GSList* g_slist_nth (GSList *list,
109 GLIB_AVAILABLE_IN_ALL
110 GSList* g_slist_find (GSList *list,
112 GLIB_AVAILABLE_IN_ALL
113 GSList* g_slist_find_custom (GSList *list,
116 GLIB_AVAILABLE_IN_ALL
117 gint g_slist_position (GSList *list,
119 GLIB_AVAILABLE_IN_ALL
120 gint g_slist_index (GSList *list,
122 GLIB_AVAILABLE_IN_ALL
123 GSList* g_slist_last (GSList *list);
124 GLIB_AVAILABLE_IN_ALL
125 guint g_slist_length (GSList *list);
126 GLIB_AVAILABLE_IN_ALL
127 void g_slist_foreach (GSList *list,
130 GLIB_AVAILABLE_IN_ALL
131 GSList* g_slist_sort (GSList *list,
132 GCompareFunc compare_func) G_GNUC_WARN_UNUSED_RESULT;
133 GLIB_AVAILABLE_IN_ALL
134 GSList* g_slist_sort_with_data (GSList *list,
135 GCompareDataFunc compare_func,
136 gpointer user_data) G_GNUC_WARN_UNUSED_RESULT;
137 GLIB_AVAILABLE_IN_ALL
138 gpointer g_slist_nth_data (GSList *list,
141 GLIB_AVAILABLE_IN_2_64
142 void g_clear_slist (GSList **slist_ptr,
143 GDestroyNotify destroy);
145 #define g_clear_slist(slist_ptr, destroy) \
149 _slist = *(slist_ptr); \
154 if ((destroy) != NULL) \
155 g_slist_free_full (_slist, (destroy)); \
157 g_slist_free (_slist); \
160 GLIB_AVAILABLE_MACRO_IN_2_64
162 #define g_slist_next(slist) ((slist) ? (((GSList *)(slist))->next) : NULL)
166 #endif /* __G_SLIST_H__ */