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