WINGs/data.c

   1 /*
   2  *  WINGs WMData function library
   3  *
   4  *  Copyright (c) 1999 Dan Pascu
   5  *
   6  *  This program is free software; you can redistribute it and/or modify
   7  *  it under the terms of the GNU General Public License as published by
   8  *  the Free Software Foundation; either version 2 of the License, or
   9  *  (at your option) any later version.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19  */
  20
  21
  22
  23 #include <string.h>
  24 #include "WUtil.h"
  25
  26
  27 typedef struct W_Data {
  28     unsigned   length;      /* How many bytes we have */
  29     unsigned   capacity;    /* How many bytes it can hold */
  30     unsigned   growth;      /* How much to grow */
  31     void       *bytes;      /* Actual data */
  32     unsigned   retainCount;
  33     unsigned   freeData:1;  /* whether the data should be released */
  34 } W_Data;
  35
  36
  37
  38
  39 /* Creating and destroying data objects */
  40
  41 WMData*
  42 WMCreateDataWithCapacity(unsigned capacity) /*FOLD00*/
  43 {
  44     WMData *aData;
  45
  46     aData = (WMData*)wmalloc(sizeof(WMData));
  47
  48     if (capacity>0)
  49         aData->bytes = wmalloc(capacity);
  50     else
  51         aData->bytes = NULL;
  52     aData->capacity = capacity;
  53     aData->growth = capacity/2 > 0 ? capacity/2 : 1;
  54     aData->length = 0;
  55     aData->retainCount = 1;
  56     aData->freeData = 1;
  57
  58     return aData;
  59 }
  60
  61
  62 WMData*
  63 WMCreateDataWithLength(unsigned length) /*FOLD00*/
  64 {
  65     WMData *aData;
  66
  67     aData = WMCreateDataWithCapacity(length);
  68     if (length>0) {
  69         memset(aData->bytes, 0, length);
  70         aData->length = length;
  71     }
  72
  73     return aData;
  74 }
  75
  76
  77 WMData*
  78 WMCreateDataWithBytes(void *bytes, unsigned length) /*FOLD00*/
  79 {
  80     WMData *aData;
  81
  82     aData = WMCreateDataWithCapacity(length);
  83     aData->length = length;
  84     memcpy(aData->bytes, bytes, length);
  85
  86     return aData;
  87 }
  88
  89
  90 WMData*
  91 WMCreateDataWithBytesNoCopy(void *bytes, unsigned length) /*FOLD00*/
  92 {
  93     WMData *aData;
  94
  95     aData = (WMData*)wmalloc(sizeof(WMData));
  96     aData->length = length;
  97     aData->capacity = length;
  98     aData->growth = length/2 > 0 ? length/2 : 1;
  99     aData->bytes = bytes;
 100     aData->retainCount = 1;
 101     aData->freeData = 0;
 102
 103     return aData;
 104 }
 105
 106
 107 WMData*
 108 WMCreateDataWithData(WMData *aData) /*FOLD00*/
 109 {
 110     if (aData->length > 0)
 111         return WMCreateDataWithBytes(aData->bytes, aData->length);
 112     else
 113         return WMCreateDataWithCapacity(0);
 114 }
 115
 116
 117 WMData*
 118 WMRetainData(WMData *aData) /*FOLD00*/
 119 {
 120     aData->retainCount++;
 121     return aData;
 122 }
 123
 124
 125 void
 126 WMReleaseData(WMData *aData) /*FOLD00*/
 127 {
 128     aData->retainCount--;
 129     if (aData->retainCount > 0)
 130         return;
 131     if (aData->bytes && aData->freeData)
 132         wfree(aData->bytes);
 133     wfree(aData);
 134 }
 135
 136
 137
 138 /* Adjusting capacity */
 139
 140 void
 141 WMSetDataCapacity(WMData *aData, unsigned capacity) /*FOLD00*/
 142 {
 143     if (aData->capacity != capacity) {
 144         aData->bytes = wrealloc(aData->bytes, capacity);
 145         aData->capacity = capacity;
 146         aData->growth = capacity/2 > 0 ? capacity/2 : 1;
 147     }
 148     if (aData->length > capacity) {
 149         aData->length = capacity;
 150     }
 151 }
 152
 153
 154 void
 155 WMSetDataLength(WMData *aData, unsigned length) /*FOLD00*/
 156 {
 157     if (length > aData->capacity) {
 158         WMSetDataCapacity(aData, length);
 159     }
 160     if (length > aData->length) {
 161         memset(aData->bytes + aData->length, 0, length - aData->length);
 162     }
 163     aData->length = length;
 164 }
 165
 166
 167 void
 168 WMIncreaseDataLengthBy(WMData *aData, unsigned extraLength) /*FOLD00*/
 169 {
 170     WMSetDataLength(aData, aData->length + extraLength);
 171 }
 172
 173
 174 /* Accessing data */
 175
 176 const void*
 177 WMDataBytes(WMData *aData) /*FOLD00*/
 178 {
 179     return aData->bytes;
 180 }
 181
 182
 183 void
 184 WMGetDataBytes(WMData *aData, void *buffer) /*FOLD00*/
 185 {
 186     wassertr(aData->length > 0);
 187
 188     memcpy(buffer, aData->bytes, aData->length);
 189 }
 190
 191
 192 void
 193 WMGetDataBytesWithLength(WMData *aData, void *buffer, unsigned length) /*FOLD00*/
 194 {
 195     wassertr(aData->length > 0);
 196     wassertr(length <= aData->length);
 197
 198     memcpy(buffer, aData->bytes, length);
 199 }
 200
 201
 202 void
 203 WMGetDataBytesWithRange(WMData *aData, void *buffer, WMRange aRange) /*FOLD00*/
 204 {
 205     wassertr(aRange.position < aData->length);
 206     wassertr(aRange.count <= aData->length-aRange.position);
 207
 208     memcpy(buffer, aData->bytes + aRange.position, aRange.count);
 209 }
 210
 211
 212 WMData*
 213 WMGetSubdataWithRange(WMData *aData, WMRange aRange) /*FOLD00*/
 214 {
 215     void *buffer;
 216
 217     /* return an empty subdata instead if aRange.count is 0 ? */
 218     wassertrv(aRange.count > 0, NULL);
 219
 220     buffer = wmalloc(aRange.count);
 221     WMGetDataBytesWithRange(aData, buffer, aRange);
 222     return WMCreateDataWithBytesNoCopy(buffer, aRange.count);
 223 }
 224
 225
 226 /* Testing data */
 227
 228 Bool
 229 WMIsDataEqualToData(WMData *aData, WMData *anotherData) /*FOLD00*/
 230 {
 231     if (aData->length != anotherData->length)
 232         return False;
 233     else if (!aData->bytes && !anotherData->bytes) /* both are empty */
 234         return True;
 235     else if (!aData->bytes || !anotherData->bytes) /* one of them is empty */
 236         return False;
 237     return (memcmp(aData->bytes, anotherData->bytes, aData->length)==0);
 238 }
 239
 240
 241 unsigned
 242 WMGetDataLength(WMData *aData) /*FOLD00*/
 243 {
 244     return aData->length;
 245 }
 246
 247
 248 unsigned
 249 WMGetDataHash(WMData *aData) /*FOLD00*/
 250 {
 251     return aData->length;
 252 }
 253
 254
 255 /* Adding data */
 256 void
 257 WMAppendDataBytes(WMData *aData, void *bytes, unsigned length) /*FOLD00*/
 258 {
 259     unsigned oldLength = aData->length;
 260     unsigned newLength = oldLength + length;
 261
 262     if (newLength > aData->capacity) {
 263         unsigned nextCapacity = aData->capacity + aData->growth;
 264         unsigned nextGrowth = aData->capacity ? aData->capacity : 1;
 265
 266         while (nextCapacity < newLength) {
 267             unsigned tmp = nextCapacity + nextGrowth;
 268
 269             nextGrowth = nextCapacity;
 270             nextCapacity = tmp;
 271         }
 272         WMSetDataCapacity(aData, nextCapacity);
 273         aData->growth = nextGrowth;
 274     }
 275     memcpy(aData->bytes + oldLength, bytes, length);
 276     aData->length = newLength;
 277 }
 278
 279
 280 void
 281 WMAppendData(WMData *aData, WMData *anotherData) /*FOLD00*/
 282 {
 283     if (anotherData->length > 0)
 284         WMAppendDataBytes(aData, anotherData->bytes, anotherData->length);
 285 }
 286
 287
 288
 289 /* Modifying data */
 290
 291 void
 292 WMReplaceDataBytesInRange(WMData *aData, WMRange aRange, void *bytes) /*FOLD00*/
 293 {
 294     wassertr(aRange.position < aData->length);
 295     wassertr(aRange.count <= aData->length-aRange.position);
 296
 297     memcpy(aData->bytes + aRange.position, bytes, aRange.count);
 298 }
 299
 300
 301 void
 302 WMResetDataBytesInRange(WMData *aData, WMRange aRange) /*FOLD00*/
 303 {
 304     wassertr(aRange.position < aData->length);
 305     wassertr(aRange.count <= aData->length-aRange.position);
 306
 307     memset(aData->bytes + aRange.position, 0, aRange.count);
 308 }
 309
 310
 311 void
 312 WMSetData(WMData *aData, WMData *anotherData) /*FOLD00*/
 313 {
 314     unsigned length = anotherData->length;
 315
 316     WMSetDataCapacity(aData, length);
 317     if (length > 0)
 318         memcpy(aData->bytes, anotherData->bytes, length);
 319     aData->length = length;
 320 }
 321
 322
 323 /* Storing data */
 324
 325