common/tr_list.c

   1 /*
   2  * Copyright (c) 2018 JANET(UK)
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  *
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  *
  12  * 2. Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the distribution.
  15  *
  16  * 3. Neither the name of JANET(UK) nor the names of its contributors
  17  *    may be used to endorse or promote products derived from this software
  18  *    without specific prior written permission.
  19  *
  20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  24  * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
  25  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  26  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  27  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  29  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  31  * OF THE POSSIBILITY OF SUCH DAMAGE.
  32  *
  33  */
  34 #include <talloc.h>
  35 #include <tr_list.h>
  36
  37 static int tr_list_destructor(void *object)
  38 {
  39   TR_LIST *list = talloc_get_type_abort(object, TR_LIST);
  40   if (*list)
  41     g_ptr_array_unref(*list);
  42   return 0;
  43 }
  44
  45 /* Note that the TR_LIST type is a pointer-to-pointer to
  46  * a GPtrArray. This is done so that we can hook a talloc destructor
  47  * to the list to ensure that the GLib reference count is handled correctly
  48  * when used with talloc. */
  49 TR_LIST *tr_list_new(TALLOC_CTX *mem_ctx)
  50 {
  51   TR_LIST *list = talloc(mem_ctx, TR_LIST);
  52   if (list) {
  53     *list = g_ptr_array_new();
  54     if (*list == NULL) {
  55       talloc_free(list);
  56       return NULL;
  57     }
  58     talloc_set_destructor((void *)list, tr_list_destructor);
  59   }
  60   return list;
  61 }
  62
  63 void tr_list_free(TR_LIST *list)
  64 {
  65   talloc_free(list);
  66 }
  67
  68 /**
  69  * Add an item to the list
  70  *
  71  * If steal != 0, performs a talloc_steal() to put the new item in the
  72  * list's context. If steal == 0, does not do this - in that case, you'll
  73  * need to be sure that the memory is cleaned up through some other means.
  74  * (This allows the list to represent non-talloc'ed items.)
  75  *
  76  * @param list list to add an item to
  77  * @param item pointer to the item to add
  78  * @param steal if non-zero, the item will be added to the list's context with talloc_steal()
  79  * @return pointer to the added item or null if there was an error
  80  */
  81 void *tr_list_add(TR_LIST *list, void *item, int steal)
  82 {
  83   guint old_len = (*list)->len;
  84   g_ptr_array_add((*list), item);
  85
  86   if ((*list)->len == old_len)
  87     return NULL; /* failed to add */
  88
  89   if (steal)
  90     talloc_steal(list, item);
  91
  92   return item;
  93 }
  94
  95 /**
  96  * Call func(item, cookie) on each item in the list.
  97  *
  98  * @param list list to iterate over
  99  * @param func function, takes two void pointer arguments, first is the item, second the cookie
 100  * @param cookie
 101  */
 102 void tr_list_foreach(TR_LIST *list, TR_LIST_FOREACH_FUNC *func, void *cookie)
 103 {
 104   g_ptr_array_foreach((*list), func, cookie);
 105 }
 106
 107 TR_LIST_ITER *tr_list_iter_new(TALLOC_CTX *mem_ctx)
 108 {
 109   TR_LIST_ITER *iter = talloc(mem_ctx, TR_LIST_ITER);
 110   if (iter)
 111     iter->list = NULL;
 112   return iter;
 113 }
 114
 115 void tr_list_iter_free(TR_LIST_ITER *iter)
 116 {
 117   talloc_free(iter);
 118 }
 119
 120 void *tr_list_iter_first(TR_LIST_ITER *iter, TR_LIST *list)
 121 {
 122   if (!iter || !list || (!(*list)))
 123     return NULL;
 124
 125   iter->list = list;
 126   iter->index = 0;
 127   return tr_list_iter_next(iter);
 128 }
 129
 130 void *tr_list_iter_next(TR_LIST_ITER *iter)
 131 {
 132   if (!iter)
 133     return NULL;
 134
 135   if (iter->index < (*(iter->list))->len)
 136     return g_ptr_array_index(*(iter->list), iter->index++);
 137   return NULL;
 138 }