Annotation of libelwix/src/sarray.c, revision 1.1
1.1 ! misho 1: /*************************************************************************
! 2: * (C) 2011 AITNET ltd - Sofia/Bulgaria - <misho@aitnet.org>
! 3: * by Michael Pounov <misho@elwix.org>
! 4: *
! 5: * $Author: misho $
! 6: * $Id: sarray.c,v 1.7 2012/07/03 08:51:05 misho Exp $
! 7: *
! 8: **************************************************************************
! 9: The ELWIX and AITNET software is distributed under the following
! 10: terms:
! 11:
! 12: All of the documentation and software included in the ELWIX and AITNET
! 13: Releases is copyrighted by ELWIX - Sofia/Bulgaria <info@elwix.org>
! 14:
! 15: Copyright 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013
! 16: by Michael Pounov <misho@elwix.org>. All rights reserved.
! 17:
! 18: Redistribution and use in source and binary forms, with or without
! 19: modification, are permitted provided that the following conditions
! 20: are met:
! 21: 1. Redistributions of source code must retain the above copyright
! 22: notice, this list of conditions and the following disclaimer.
! 23: 2. Redistributions in binary form must reproduce the above copyright
! 24: notice, this list of conditions and the following disclaimer in the
! 25: documentation and/or other materials provided with the distribution.
! 26: 3. All advertising materials mentioning features or use of this software
! 27: must display the following acknowledgement:
! 28: This product includes software developed by Michael Pounov <misho@elwix.org>
! 29: ELWIX - Embedded LightWeight unIX and its contributors.
! 30: 4. Neither the name of AITNET nor the names of its contributors
! 31: may be used to endorse or promote products derived from this software
! 32: without specific prior written permission.
! 33:
! 34: THIS SOFTWARE IS PROVIDED BY AITNET AND CONTRIBUTORS ``AS IS'' AND
! 35: ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 36: IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 37: ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
! 38: FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 39: DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 40: OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 41: HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 42: LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 43: OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 44: SUCH DAMAGE.
! 45: */
! 46: #include "global.h"
! 47:
! 48:
! 49: /*
! 50: * sarr_Init() - Create and initialize dynamic split-order array
! 51: *
! 52: * @numItems = Number of Items
! 53: * @segLen = Length of segment
! 54: * return: NULL error, != NULL allocated memory for array
! 55: */
! 56: sarr_t *
! 57: sarr_Init(int numItems, int segLen)
! 58: {
! 59: sarr_t *arr = NULL;
! 60:
! 61: if (segLen < 1)
! 62: return NULL;
! 63:
! 64: arr = e_malloc(sizeof(sarr_t));
! 65: if (!arr)
! 66: return NULL;
! 67:
! 68: arr->sarr_num = numItems;
! 69: arr->sarr_seg = segLen;
! 70: arr->sarr_siz = numItems / segLen + 1;
! 71: arr->sarr_data = e_calloc(arr->sarr_siz, sizeof(sarr_seg_t));
! 72: if (!arr->sarr_data) {
! 73: e_free(arr);
! 74: return NULL;
! 75: } else
! 76: memset(arr->sarr_data, 0, arr->sarr_siz * sizeof(sarr_seg_t));
! 77:
! 78: return arr;
! 79: }
! 80:
! 81: /*
! 82: * sarr_Destroy() - Free all data in dynamic split-order array and Destroy array
! 83: *
! 84: * @parr = Array
! 85: * return: none
! 86: */
! 87: void
! 88: sarr_Destroy(sarr_t ** __restrict parr)
! 89: {
! 90: register int i;
! 91:
! 92: if (!parr || !*parr)
! 93: return;
! 94:
! 95: for (i = 0; i < (*parr)->sarr_siz; i++)
! 96: if ((*parr)->sarr_data[i]) {
! 97: e_free((*parr)->sarr_data[i]);
! 98: (*parr)->sarr_data[i] = NULL;
! 99: }
! 100:
! 101: if ((*parr)->sarr_data)
! 102: e_free((*parr)->sarr_data);
! 103: e_free(*parr);
! 104: *parr = NULL;
! 105: }
! 106:
! 107: /*
! 108: * sarr_Copy() Copy source split array to destination split array
! 109: *
! 110: * @dest = Destination split array, after use free with sarr_Destroy()
! 111: * @src = Source split array
! 112: * return: -1 error; >0 count of destination split array
! 113: */
! 114: int
! 115: sarr_Copy(sarr_t ** __restrict dest, sarr_t * __restrict src)
! 116: {
! 117: if (!dest || !src)
! 118: return -1;
! 119:
! 120: *dest = sarr_Init(sarr_Size(src), sarr_Seg(src));
! 121: if (!*dest)
! 122: return -1;
! 123:
! 124: memcpy((*dest)->sarr_data, src->sarr_data, (*dest)->sarr_siz * sizeof(sarr_seg_t));
! 125: return sarr_Size(*dest);
! 126: }
! 127:
! 128: /*
! 129: * sarr_Vacuum() - Vacuum dynamic split-order array, empty segments will be freed
! 130: *
! 131: * @arr = Array
! 132: * return: -1 error, >-1 freed segments
! 133: */
! 134: int
! 135: sarr_Vacuum(sarr_t * __restrict arr)
! 136: {
! 137: register int i, j;
! 138: int cx = 0;
! 139: sarr_seg_t seg;
! 140:
! 141: if (!arr)
! 142: return -1;
! 143:
! 144: for (i = 0; i < arr->sarr_siz; i++)
! 145: if (arr->sarr_data[i]) {
! 146: for (j = 0, seg = arr->sarr_data[i]; j < arr->sarr_seg; j++)
! 147: if (seg[j])
! 148: break;
! 149: if (j == arr->sarr_seg) {
! 150: e_free(arr->sarr_data[i]);
! 151: arr->sarr_data[i] = NULL;
! 152: cx++;
! 153: }
! 154: }
! 155:
! 156: return cx;
! 157: }
! 158:
! 159: /*
! 160: * sarr_Grow() - Grow/Shrink dynamic split-order array, Use with care when it shrink!!!
! 161: *
! 162: * @arr = Array
! 163: * @newNumItems = Number of Items
! 164: * return: -1 error, 0 ok
! 165: */
! 166: int
! 167: sarr_Grow(sarr_t * __restrict arr, int newNumItems)
! 168: {
! 169: sarr_seg_t *data;
! 170: int seg, n = 0;
! 171: register int i;
! 172:
! 173: if (!arr)
! 174: return -1;
! 175:
! 176: arr->sarr_num = newNumItems;
! 177: seg = newNumItems / arr->sarr_seg + 1;
! 178: if (arr->sarr_siz == seg)
! 179: return n;
! 180: if (arr->sarr_siz < seg)
! 181: n = seg - arr->sarr_siz;
! 182: else
! 183: for (i = seg; i < arr->sarr_siz; i++)
! 184: if (arr->sarr_data[i])
! 185: e_free(arr->sarr_data[i]);
! 186:
! 187: arr->sarr_siz = seg;
! 188: data = e_realloc(arr->sarr_data, arr->sarr_siz * sizeof(sarr_seg_t));
! 189: if (!data)
! 190: return -1;
! 191: else
! 192: arr->sarr_data = data;
! 193: memset(arr->sarr_data + (arr->sarr_siz - n), 0, n * sizeof(sarr_seg_t));
! 194:
! 195: return 0;
! 196: }
! 197:
! 198: /*
! 199: * sarr_Get() - Get element from dynamic split-order array
! 200: *
! 201: * @arr = Array
! 202: * @idx = Index (warning 1st element is at position 1)
! 203: * return: NULL not found, !=NULL element
! 204: */
! 205: inline void *
! 206: sarr_Get(sarr_t * __restrict arr, u_int idx)
! 207: {
! 208: void *ret = NULL;
! 209: sarr_seg_t seg;
! 210:
! 211: if (!arr || idx < 1 || arr->sarr_num < idx)
! 212: return ret;
! 213:
! 214: seg = arr->sarr_data[idx / arr->sarr_seg];
! 215: if (seg)
! 216: ret = seg[idx % arr->sarr_seg];
! 217:
! 218: return ret;
! 219: }
! 220:
! 221: /*
! 222: * sarr_Get2() - Always get element from dynamic split-order array
! 223: * Function automatic grow array. Good use for Hash tables!
! 224: *
! 225: * @arr = Array
! 226: * @idx = Index (warning 1st element is at position 1)
! 227: * return: NULL not found, !=NULL element
! 228: */
! 229: void *
! 230: sarr_Get2(sarr_t * __restrict arr, u_int idx)
! 231: {
! 232: if (!arr || idx < 1)
! 233: return NULL;
! 234: if (arr->sarr_num < idx)
! 235: if (sarr_Grow(arr, idx))
! 236: return NULL;
! 237: return sarr_Get(arr, idx);
! 238: }
! 239:
! 240: /*
! 241: * sarr_Set() - Set element to dynamic split-order array
! 242: *
! 243: * @arr = Array
! 244: * @idx = Index (warning 1st element is at position 1)
! 245: * @data = Value
! 246: * return: NULL error or empty, !=NULL old value in element
! 247: */
! 248: inline void *
! 249: sarr_Set(sarr_t * __restrict arr, u_int idx, void *data)
! 250: {
! 251: void *ret = NULL;
! 252: sarr_seg_t seg;
! 253: register int pos;
! 254:
! 255: if (!arr || idx < 1 || arr->sarr_num < idx)
! 256: return ret;
! 257:
! 258: seg = arr->sarr_data[idx / arr->sarr_seg];
! 259: if (!seg) {
! 260: seg = e_calloc(arr->sarr_seg, sizeof(void*));
! 261: if (!seg)
! 262: return ret;
! 263: else
! 264: memset(seg, 0, arr->sarr_seg * sizeof(void*));
! 265: arr->sarr_data[idx / arr->sarr_seg] = seg;
! 266: }
! 267:
! 268: pos = idx % arr->sarr_seg;
! 269: ret = seg[pos];
! 270: seg[pos] = data;
! 271:
! 272: return ret;
! 273: }
! 274:
! 275: /*
! 276: * sarr_sarr2array() - Convert from split-order array to dynamic array
! 277: *
! 278: * @sa = split array
! 279: * @sarrFree = after convert split array !=0 will be destroyed sarray
! 280: * return: NULL error or != NULL new array
! 281: */
! 282: array_t *
! 283: sarr_sarr2array(sarr_t ** __restrict sa, int sarrFree)
! 284: {
! 285: array_t *arr = NULL;
! 286: int el;
! 287: register int i;
! 288:
! 289: if (!sa || !*sa)
! 290: return NULL;
! 291:
! 292: el = sarr_Size(*sa);
! 293: arr = array_Init(el);
! 294: if (!arr)
! 295: return NULL;
! 296:
! 297: for (i = 0; i < el; i++)
! 298: array_Set(arr, i, sarr_Get(*sa, i + 1));
! 299:
! 300: if (sarrFree) {
! 301: e_free(*sa);
! 302: *sa = NULL;
! 303: }
! 304: return arr;
! 305: }
! 306:
! 307: /*
! 308: * sarr_array2sarr() - Convert from dynamic array to split-order array
! 309: *
! 310: * @a = array
! 311: * @segLen = Length of segment
! 312: * @arrFree = after convert array !=0 will be destroyed
! 313: * return: NULL error or != NULL new sarr
! 314: */
! 315: sarr_t *
! 316: sarr_array2sarr(array_t ** __restrict a, int segLen, int arrFree)
! 317: {
! 318: sarr_t *sa = NULL;
! 319: int el;
! 320: register int i;
! 321:
! 322: if (!a || !*a)
! 323: return NULL;
! 324:
! 325: el = array_Size(*a);
! 326: sa = sarr_Init(el, segLen);
! 327: if (!sa)
! 328: return NULL;
! 329:
! 330: for (i = 0; i < el; i++)
! 331: sarr_Set(sa, i + 1, array_Get(*a, i));
! 332:
! 333: if (arrFree) {
! 334: e_free(*a);
! 335: *a = NULL;
! 336: }
! 337: return sa;
! 338: }
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>