glib/gtrashstack.h

   1 /* GLIB - Library of useful routines for C programming
   2  * Copyright (C) 1995-1997  Peter Mattis, Spencer Kimball and Josh MacDonald
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 /*
  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/.
  25  */
  26
  27 #if !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
  28 #error "Only <glib.h> can be included directly."
  29 #endif
  30
  31 #ifndef __G_TRASH_STACK_H__
  32 #define __G_TRASH_STACK_H__
  33
  34 #include <glib/gutils.h>
  35
  36 G_BEGIN_DECLS
  37
  38 typedef struct _GTrashStack GTrashStack;
  39 struct _GTrashStack
  40 {
  41   GTrashStack *next;
  42 };
  43
  44 G_INLINE_FUNC void      g_trash_stack_push   (GTrashStack **stack_p,
  45                                               gpointer      data_p);
  46 G_INLINE_FUNC gpointer  g_trash_stack_pop    (GTrashStack **stack_p);
  47 G_INLINE_FUNC gpointer  g_trash_stack_peek   (GTrashStack **stack_p);
  48 G_INLINE_FUNC guint     g_trash_stack_height (GTrashStack **stack_p);
  49
  50 #if defined (G_CAN_INLINE) || defined (__G_TRASH_STACK_C__)
  51
  52 G_INLINE_FUNC void
  53 g_trash_stack_push (GTrashStack **stack_p,
  54                     gpointer      data_p)
  55 {
  56   GTrashStack *data = (GTrashStack *) data_p;
  57
  58   data->next = *stack_p;
  59   *stack_p = data;
  60 }
  61 G_INLINE_FUNC gpointer
  62 g_trash_stack_pop (GTrashStack **stack_p)
  63 {
  64   GTrashStack *data;
  65
  66   data = *stack_p;
  67   if (data)
  68     {
  69       *stack_p = data->next;
  70       /* NULLify private pointer here, most platforms store NULL as
  71        * subsequent 0 bytes
  72        */
  73       data->next = NULL;
  74     }
  75
  76   return data;
  77 }
  78 G_INLINE_FUNC gpointer
  79 g_trash_stack_peek (GTrashStack **stack_p)
  80 {
  81   GTrashStack *data;
  82
  83   data = *stack_p;
  84
  85   return data;
  86 }
  87 G_INLINE_FUNC guint
  88 g_trash_stack_height (GTrashStack **stack_p)
  89 {
  90   GTrashStack *data;
  91   guint i = 0;
  92
  93   for (data = *stack_p; data; data = data->next)
  94     i++;
  95
  96   return i;
  97 }
  98
  99 #endif  /* G_CAN_INLINE || __G_TRASH_STACK_C__ */
 100
 101 G_END_DECLS
 102
 103 #endif /* __G_UTILS_H__ */