Mercurial > code
annotate array.h @ 30:e2c3a0a549d2
Rename SIZE -> OFFSET
author | David Demelier <markand@malikania.fr> |
---|---|
date | Fri, 23 Sep 2011 08:57:26 +0200 |
parents | 19c0d2e11406 |
children | 653bb22d3c0c |
rev | line source |
---|---|
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
1 /* |
14 | 2 * array.h -- manipulate dynamic arrays |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
3 * |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
4 * Copyright (c) 2011, David Demelier <markand@malikania.fr> |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
5 * |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
6 * Permission to use, copy, modify, and/or distribute this software for any |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
7 * purpose with or without fee is hereby granted, provided that the above |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
8 * copyright notice and this permission notice appear in all copies. |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
9 * |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
10 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
11 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
12 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
13 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
14 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
15 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
16 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
17 */ |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
18 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
19 #ifndef _ARRAY_H_ |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
20 #define _ARRAY_H_ |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
21 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
22 #define ARRAY_DEFAULT_BSIZE 128 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
23 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
24 struct array { |
25
e09000fc013a
Switch to void * thus the user do not need to cast
David Demelier <markand@malikania.fr>
parents:
22
diff
changeset
|
25 void *data; /* array of data */ |
e09000fc013a
Switch to void * thus the user do not need to cast
David Demelier <markand@malikania.fr>
parents:
22
diff
changeset
|
26 void *tmp; /* only used for array_swap() */ |
8
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
27 int length; /* number of element inside */ |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
28 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
29 #define ARRAY_FIXED 0x00000000 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
30 #define ARRAY_AUTO 0x00000001 |
22
ecdf21f1d0c6
Added a new function array_swap() that swap elements by index
David Demelier <markand@malikania.fr>
parents:
19
diff
changeset
|
31 int flags; /* array's flags (default FIXED) */ |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
32 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
33 /* Private should not be modified by user */ |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
34 size_t size; /* current buffer size */ |
30 | 35 size_t unit; /* unit size (sizeof the object) */ |
8
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
36 size_t bsize; /* block size (used when growing array) */ |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
37 }; |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
38 |
8
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
39 struct array *array_new(const void *, size_t, size_t, int); |
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
40 #define array_new_auto(size) array_new(NULL, size, 0, ARRAY_AUTO) |
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
41 #define array_new_fixed(size, max) array_new(NULL, size, max, ARRAY_FIXED) |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
42 |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
43 int array_push(struct array *, const void *); |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
44 int array_insert(struct array *, const void *, int); |
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
45 int array_append(struct array *, const void *); |
29
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
46 void array_pop(struct array *); |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
47 void array_unqueue(struct array *); |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
48 void array_remove(struct array *, int); |
22
ecdf21f1d0c6
Added a new function array_swap() that swap elements by index
David Demelier <markand@malikania.fr>
parents:
19
diff
changeset
|
49 int array_swap(struct array *, int, int); |
29
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
50 void array_map(const struct array *, void (*fn)(void *, void *), void *); |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
51 void *array_find(const struct array *, int (*fn)(void *, void *), int *, void *); |
8
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
52 void array_clear(struct array *); |
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
53 void array_free(struct array *); |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
54 |
27
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
55 #define ARRAY_FOREACH(a, var, i) \ |
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
56 for (i = 0, var = a->data; i < a->length; ++i, ++var) |
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
57 |
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
58 #define ARRAY_FOREACH_R(a, var, i) \ |
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
59 for (i = 0, \ |
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
60 var = (void *) ((char *) a->data + a->unit * (a->length - 1)); \ |
02b0ee204042
Added ARRAY_FOREACH_R. Same functionality as ARRAY_FOREACH but reversal.
David Demelier <markand@malikania.fr>
parents:
25
diff
changeset
|
61 i < a->length; ++i, --var) |
6
25cc379de564
Added array.c and array.h:
David Demelier <markand@malikania.fr>
parents:
diff
changeset
|
62 |
29
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
63 #define ARRAY_HEAD(a) \ |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
64 a->data |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
65 #define ARRAY_TAIL(a) \ |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
66 (void *) ((char *) a->data + (a->unit * (a->length - 1))) |
19c0d2e11406
Security fixes for array
David Demelier <markand@malikania.fr>
parents:
27
diff
changeset
|
67 |
8
127254037b30
Switch to a void * array instead of void **
David Demelier <markand@malikania.fr>
parents:
6
diff
changeset
|
68 #endif /* _ARRAY_H_ */ |