src/xbt/dict_multi.c

   1 /* $Id$ */
   2
   3 /* dict_multi - dictionnaries of dictionnaries of ... of data               */
   4
   5 /* Copyright (c) 2003-2005 Martin Quinson. All rights reserved.             */
   6
   7 /* This program is free software; you can redistribute it and/or modify it
   8  * under the terms of the license (GNU LGPL) which comes with this package. */
   9
  10 #include "dict_private.h"
  11
  12 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_dict_multi,xbt_dict, "Dictionaries of multiple keys");
  13
  14 static void _free_dict(void*d) {
  15   VERB1("free dict %p",d);
  16   xbt_dict_free((xbt_dict_t*)&d);
  17 }
  18
  19 /** \brief Insert \e data under all the keys contained in \e keys, providing their sizes in \e lens.
  20  *
  21  * \arg mdict: the multi-dict
  22  * \arg keys: dynar of (char *) containing all the keys
  23  * \arg lens: length of each element of \e keys
  24  * \arg data: what to store in the structure
  25  * \arg free_ctn: function to use to free the pushed content on need
  26  *
  27  * Dynars are not modified during the operation.
  28  */
  29
  30 void
  31 xbt_multidict_set_ext(xbt_dict_t  mdict,
  32                       xbt_dynar_t keys, xbt_dynar_t     lens,
  33                       void       *data, void_f_pvoid_t  free_ctn) {
  34
  35   xbt_dict_t thislevel,nextlevel=NULL;
  36   int i;
  37
  38   unsigned long int thislen;
  39   char *thiskey;
  40   int keys_len=xbt_dynar_length(keys);
  41
  42   xbt_assert(xbt_dynar_length(keys) == xbt_dynar_length(lens));
  43   xbt_assert0(keys_len, "Can't set a zero-long key set in a multidict");
  44
  45   DEBUG2("xbt_multidict_set(%p,%d)", mdict, keys_len);
  46
  47   for (i=0 , thislevel = mdict    ;
  48        i<keys_len-1               ;
  49        i++ , thislevel = nextlevel) {
  50
  51     xbt_dynar_get_cpy(keys, i, &thiskey);
  52     xbt_dynar_get_cpy(lens, i, &thislen);
  53
  54     DEBUG5("multi_set: at level %d, len=%ld, key=%p |%*s|", i, thislen, thiskey, (int)thislen,thiskey);
  55
  56     /* search the dict of next level */
  57     nextlevel = xbt_dict_get_or_null_ext(thislevel, thiskey, thislen);
  58     if (nextlevel == NULL) {
  59       /* make sure the dict of next level exists */
  60       nextlevel=xbt_dict_new();
  61       VERB1("Create a dict (%p)",nextlevel);
  62       xbt_dict_set_ext(thislevel, thiskey, thislen, nextlevel, &_free_dict);
  63     }
  64   }
  65
  66   xbt_dynar_get_cpy(keys, i, &thiskey);
  67   xbt_dynar_get_cpy(lens, i, &thislen);
  68
  69   xbt_dict_set_ext(thislevel, thiskey, thislen, data, free_ctn);
  70 }
  71
  72 /** \brief Insert \e data under all the keys contained in \e keys
  73  *
  74  * \arg head: the head of dict
  75  * \arg keys: dynar of null-terminated strings containing all the keys
  76  * \arg data: what to store in the structure
  77  * \arg free_ctn: function to use to free the pushed content on need
  78  */
  79 void
  80 xbt_multidict_set(xbt_dict_t  mdict,
  81                   xbt_dynar_t keys,
  82                   void       *data,  void_f_pvoid_t free_ctn) {
  83   xbt_dynar_t lens = xbt_dynar_new(sizeof(unsigned long int),NULL);
  84   unsigned long i;
  85   xbt_ex_t e;
  86
  87   for (i = 0; i < xbt_dynar_length(keys); i++) {
  88     char *thiskey = xbt_dynar_get_as(keys, i, char*);
  89     unsigned long int thislen = (unsigned long int) strlen(thiskey);
  90     DEBUG2("Push %ld as level %lu length",thislen, i);
  91     xbt_dynar_push(lens,&thislen);
  92   }
  93
  94   TRY {
  95     xbt_multidict_set_ext(mdict, keys, lens, data, free_ctn);
  96   } CLEANUP {
  97     xbt_dynar_free(&lens);
  98   } CATCH(e) {
  99     RETHROW;
 100   }
 101 }
 102
 103 /** \brief Insert \e data under all the keys contained in \e keys, providing their sizes in \e lens.
 104  *
 105  * \arg mdict: the multi-dict
 106  * \arg keys: dynar of (char *) containing all the keys
 107  * \arg lens: length of each element of \e keys
 108  * \arg data: where to put what was found in structure
 109  * \arg free_ctn: function to use to free the pushed content on need
 110  *
 111  * Dynars are not modified during the operation.
 112  */
 113 void *
 114 xbt_multidict_get_ext(xbt_dict_t  mdict,
 115                       xbt_dynar_t keys,   xbt_dynar_t lens) {
 116   xbt_dict_t thislevel,nextlevel;
 117   int i;
 118
 119   unsigned long int thislen;
 120   char *thiskey;
 121   int keys_len=xbt_dynar_length(keys);
 122
 123   xbt_assert(xbt_dynar_length(keys) == xbt_dynar_length(lens));
 124   xbt_assert0(xbt_dynar_length(keys) >= 1, "Can't get a zero-long key set in a multidict");
 125
 126   DEBUG2("xbt_multidict_get(%p, %ld)", mdict, xbt_dynar_length(keys));
 127
 128   for (i=0         , thislevel=mdict      ;
 129   i<keys_len-1                       ;
 130   i++         , thislevel = nextlevel) {
 131
 132     xbt_dynar_get_cpy(keys, i, &thiskey);
 133     xbt_dynar_get_cpy(lens, i, &thislen);
 134
 135     DEBUG6("multi_get: at level %d (%p), len=%ld, key=%p |%*s|",
 136            i, thislevel, thislen, thiskey, (int)thislen,thiskey);
 137
 138     /* search the dict of next level: let mismatch raise if not found */
 139     nextlevel = xbt_dict_get_ext(thislevel, thiskey, thislen);
 140   }
 141
 142   xbt_dynar_get_cpy(keys, i, &thiskey);
 143   xbt_dynar_get_cpy(lens, i, &thislen);
 144
 145   return xbt_dict_get_ext(thislevel, thiskey, thislen);
 146 }
 147
 148 void *
 149 xbt_multidict_get(xbt_dict_t mdict, xbt_dynar_t keys) {
 150   xbt_dynar_t lens = xbt_dynar_new(sizeof(unsigned long int),NULL);
 151   unsigned long i;
 152   void *res;
 153
 154   for (i = 0; i < xbt_dynar_length(keys); i++) {
 155     char *thiskey = xbt_dynar_get_as(keys, i, char*);
 156     unsigned long int thislen = (unsigned long int) strlen(thiskey);
 157     xbt_dynar_push(lens,&thislen);
 158   }
 159
 160   res = xbt_multidict_get_ext(mdict, keys, lens),
 161   xbt_dynar_free(&lens);
 162   return res;
 163 }
 164
 165
 166 /** \brief Remove the entry under all the keys contained in \e keys, providing their sizes in \e lens.
 167  *
 168  * \arg mdict: the multi-dict
 169  * \arg keys: dynar of (char *) containing all the keys
 170  * \arg lens: length of each element of \e keys
 171  * \arg data: what to store in the structure
 172  * \arg free_ctn: function to use to free the pushed content on need
 173  *
 174  * Dynars are not modified during the operation.
 175  *
 176  * Removing a non-existant key is ok.
 177  */
 178
 179 void
 180 xbt_multidict_remove_ext(xbt_dict_t mdict, xbt_dynar_t keys, xbt_dynar_t lens) {
 181   xbt_dict_t thislevel,nextlevel=NULL;
 182   int i;
 183   xbt_ex_t e;
 184
 185   unsigned long int thislen;
 186   char *thiskey;
 187   int keys_len=xbt_dynar_length(keys);
 188
 189   xbt_assert(xbt_dynar_length(keys) == xbt_dynar_length(lens));
 190   xbt_assert0(xbt_dynar_length(keys), "Can't remove a zero-long key set in a multidict");
 191
 192   for (i=0         , thislevel=mdict      ;
 193   i<keys_len-1                       ;
 194   i++         , thislevel = nextlevel) {
 195
 196     xbt_dynar_get_cpy(keys, i, &thiskey);
 197     xbt_dynar_get_cpy(lens, i, &thislen);
 198
 199     /* search the dict of next level */
 200     TRY {
 201       nextlevel = xbt_dict_get_ext(thislevel, thiskey, thislen);
 202     } CATCH(e) {
 203       /* If non-existant entry, nothing to do */
 204       if (e.category == arg_error)
 205         xbt_ex_free(e);
 206       else
 207         RETHROW;
 208     }
 209   }
 210
 211   xbt_dynar_get_cpy(keys, i, &thiskey);
 212   xbt_dynar_get_cpy(lens, i, &thislen);
 213
 214   xbt_dict_remove_ext(thislevel, thiskey, thislen);
 215 }
 216
 217 void
 218 xbt_multidict_remove(xbt_dict_t mdict, xbt_dynar_t keys) {
 219
 220   xbt_ex_t e;
 221   xbt_dynar_t lens = xbt_dynar_new(sizeof(unsigned long int),NULL);
 222   unsigned long i;
 223
 224   for (i = 0; i < xbt_dynar_length(keys); i++) {
 225     char *thiskey = xbt_dynar_get_as(keys, i, char*);
 226     unsigned long int thislen = strlen(thiskey);
 227     xbt_dynar_push(lens,&thislen);
 228   }
 229
 230   TRY {
 231     xbt_multidict_remove_ext(mdict, keys, lens);
 232   } CLEANUP {
 233     xbt_dynar_free(&lens);
 234   } CATCH(e) {
 235     RETHROW;
 236   }
 237 }