1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
|
/* EINA - EFL data type library
* Copyright (C) 2008 Cedric Bail
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library;
* if not, see <http://www.gnu.org/licenses/>.
*/
#ifndef EINA_INLINE_ARRAY_X_
#define EINA_INLINE_ARRAY_X_
#include <stddef.h>
#include <stdio.h>
/**
* @cond LOCAL
*/
EAPI Eina_Bool eina_array_grow(Eina_Array *array);
/**
* @endcond
*/
/**
* @addtogroup Eina_Array_Group Array
*
* @brief These functions provide array management.
*
* @{
*/
/**
* @brief Append a data to an array.
*
* @param array The array.
* @param data The data to add.
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
*
* This function appends @p data to @p array. For performance
* reasons, there is no check of @p array. If it is @c NULL or
* invalid, the program may crash. If @p data is @c NULL, or if an
* allocation is necessary and fails, #EINA_FALSE is returned and
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, #EINA_TRUE is
* returned.
*/
static inline Eina_Bool
eina_array_push(Eina_Array *array, const void *data)
{
if (!data) return EINA_FALSE;
if (EINA_UNLIKELY((array->count + 1) > array->total))
if (!eina_array_grow(array))
return EINA_FALSE;
array->data[array->count++] = (void*) data;
return EINA_TRUE;
}
/**
* @brief Remove the last data of an array.
*
* @param array The array.
* @return The retrieved data.
*
* This function removes the last data of @p array, decreases the count
* of @p array and returns the data. For performance reasons, there
* is no check of @p array. If it is @c NULL or invalid, the program
* may crash. If the count member is less or equal than 0, @c NULL is
* returned.
*/
static inline void *
eina_array_pop(Eina_Array *array)
{
void *ret = NULL;
if (array->count <= 0)
goto on_empty;
ret = array->data[--array->count];
on_empty:
return ret;
}
/**
* @brief Return the data at a given position in an array.
*
* @param array The array.
* @param idx The potition of the data to retrieve.
* @return The retrieved data.
*
* This function returns the data at the position @p idx in @p
* array. For performance reasons, there is no check of @p array or @p
* idx. If it is @c NULL or invalid, the program may crash.
*/
static inline void *
eina_array_data_get(const Eina_Array *array, unsigned int idx)
{
return array->data[idx];
}
static inline void
eina_array_data_set(const Eina_Array *array, unsigned int idx, const void *data)
{
array->data[idx] = (void*) data;
}
/**
* @brief Return the number of elements in an array.
*
* @param array The array.
* @return The number of elements.
*
* This function returns the number of elements in @p array. For
* performance reasons, there is no check of @p array. If it is
* @c NULL or invalid, the program may crash.
*
* @deprecated use eina_array_count()
*/
static inline unsigned int
eina_array_count_get(const Eina_Array *array)
{
return array->count;
}
/**
* @brief Return the number of elements in an array.
*
* @param array The array.
* @return The number of elements.
*
* This function returns the number of elements in @p array. For
* performance reasons, there is no check of @p array. If it is
* @c NULL or invalid, the program may crash.
*/
static inline unsigned int
eina_array_count(const Eina_Array *array)
{
return array->count;
}
static inline Eina_Bool
eina_array_foreach(Eina_Array *array, Eina_Each_Cb cb, void *fdata)
{
void *data;
Eina_Array_Iterator iterator;
unsigned int i;
Eina_Bool ret = EINA_TRUE;
EINA_ARRAY_ITER_NEXT(array, i, data, iterator)
if (cb(array, data, fdata) != EINA_TRUE)
{
ret = EINA_FALSE;
break;
}
return ret;
}
static inline void
eina_array_clean(Eina_Array *array)
{
array->count = 0;
}
/**
* @}
*/
#endif
|
