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