2008-08-06 11:15:24 -07:00
|
|
|
/* 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/>.
|
|
|
|
*/
|
|
|
|
|
2008-07-30 09:34:54 -07:00
|
|
|
#ifndef EINA_ARRAY_H_
|
|
|
|
#define EINA_ARRAY_H_
|
|
|
|
|
2008-08-01 05:26:35 -07:00
|
|
|
#include <stdlib.h>
|
|
|
|
|
2008-09-26 04:41:55 -07:00
|
|
|
#include "eina_config.h"
|
|
|
|
|
2008-07-30 09:34:54 -07:00
|
|
|
#include "eina_types.h"
|
2008-09-07 12:12:49 -07:00
|
|
|
#include "eina_error.h"
|
2008-08-11 09:30:16 -07:00
|
|
|
#include "eina_iterator.h"
|
|
|
|
#include "eina_accessor.h"
|
2008-09-25 07:46:16 -07:00
|
|
|
#include "eina_magic.h"
|
2008-07-30 09:34:54 -07:00
|
|
|
|
2008-09-07 12:12:49 -07:00
|
|
|
/**
|
2008-09-18 22:22:43 -07:00
|
|
|
* @addtogroup Eina_Data_Types_Group Data Types
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup Eina_Containers_Group Containers
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @defgroup Eina_Array_Group Array
|
2008-09-07 12:12:49 -07:00
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
2008-08-11 09:30:16 -07:00
|
|
|
|
2008-09-07 12:12:49 -07:00
|
|
|
/**
|
|
|
|
* @typedef Eina_Array
|
2008-09-18 22:22:43 -07:00
|
|
|
* Type for a generic vector.
|
2008-09-07 12:12:49 -07:00
|
|
|
*/
|
|
|
|
typedef struct _Eina_Array Eina_Array;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @typedef Eina_Array_Iterator
|
2008-09-15 12:17:15 -07:00
|
|
|
* Type for an iterator on arrays, used with #EINA_ARRAY_ITER_NEXT.
|
2008-09-07 12:12:49 -07:00
|
|
|
*/
|
|
|
|
typedef void **Eina_Array_Iterator;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @struct _Eina_Array
|
|
|
|
* Type for an array of data.
|
|
|
|
*/
|
|
|
|
struct _Eina_Array
|
2008-07-30 09:34:54 -07:00
|
|
|
{
|
2010-08-19 05:02:28 -07:00
|
|
|
#define EINA_ARRAY_VERSION 1
|
2010-10-22 23:41:45 -07:00
|
|
|
int version; /**< Should match EINA_ARRAY_VERSION used when compiled your apps, provided for ABI compatibility */
|
2010-08-19 05:02:28 -07:00
|
|
|
|
2010-10-22 23:41:45 -07:00
|
|
|
void **data; /**< Pointer to a vector of pointer to payload */
|
2010-08-09 20:26:15 -07:00
|
|
|
unsigned int total; /**< Total number of slots in the vector */
|
|
|
|
unsigned int count; /**< Number of active slots in the vector */
|
2010-07-27 19:37:05 -07:00
|
|
|
unsigned int step; /**< How much must we grow the vector when it is full */
|
* eina/src/include/eina_array.h,
* eina/src/include/eina_f16p16.h,
* eina/src/include/eina_accessor.h,
* eina/src/include/eina_list.h,
* eina/src/include/eina_iterator.h,
* eina/src/lib/eina_rectangle.c,
* eina/src/lib/eina_list.c,
* eina/src/lib/eina_array.c,
* eina/src/lib/eina_hash.c,
* eina/src/lib/eina_module.c,
* eina/src/lib/eina_stringshare.c,
* eina/src/lib/eina_benchmark.c: Fix for windows compilation.
SVN revision: 38663
2009-01-20 07:56:48 -08:00
|
|
|
EINA_MAGIC
|
2008-07-30 09:34:54 -07:00
|
|
|
};
|
|
|
|
|
2010-10-22 23:41:45 -07:00
|
|
|
EAPI Eina_Array *eina_array_new(unsigned int step) EINA_WARN_UNUSED_RESULT EINA_MALLOC EINA_WARN_UNUSED_RESULT;
|
|
|
|
EAPI void eina_array_free(Eina_Array *array) EINA_ARG_NONNULL(1);
|
|
|
|
EAPI void eina_array_step_set(Eina_Array *array,
|
|
|
|
unsigned int sizeof_eina_array,
|
|
|
|
unsigned int step) EINA_ARG_NONNULL(1);
|
2010-11-29 10:32:30 -08:00
|
|
|
static inline void eina_array_clean(Eina_Array *array) EINA_ARG_NONNULL(1);
|
2010-10-22 23:41:45 -07:00
|
|
|
EAPI void eina_array_flush(Eina_Array *array) EINA_ARG_NONNULL(1);
|
|
|
|
EAPI Eina_Bool eina_array_remove(Eina_Array * array,
|
|
|
|
Eina_Bool (*keep)(void *data, void *gdata),
|
|
|
|
void *gdata) EINA_ARG_NONNULL(1, 2);
|
|
|
|
static inline Eina_Bool eina_array_push(Eina_Array *array,
|
|
|
|
const void *data) EINA_ARG_NONNULL(1, 2);
|
|
|
|
static inline void *eina_array_pop(Eina_Array *array) EINA_ARG_NONNULL(1);
|
|
|
|
static inline void *eina_array_data_get(const Eina_Array *array,
|
|
|
|
unsigned int idx) EINA_ARG_NONNULL(1);
|
|
|
|
static inline void eina_array_data_set(const Eina_Array *array,
|
|
|
|
unsigned int idx,
|
2010-11-25 11:38:45 -08:00
|
|
|
const void *data) EINA_ARG_NONNULL(1);
|
2010-10-22 23:41:45 -07:00
|
|
|
static inline unsigned int eina_array_count_get(const Eina_Array *array) EINA_ARG_NONNULL(1);
|
|
|
|
EAPI Eina_Iterator *eina_array_iterator_new(const Eina_Array *array) EINA_MALLOC EINA_ARG_NONNULL(1) EINA_WARN_UNUSED_RESULT;
|
|
|
|
EAPI Eina_Accessor *eina_array_accessor_new(const Eina_Array *array) EINA_MALLOC EINA_ARG_NONNULL(1) EINA_WARN_UNUSED_RESULT;
|
|
|
|
static inline Eina_Bool eina_array_foreach(Eina_Array *array,
|
|
|
|
Eina_Each_Cb cb,
|
|
|
|
void *data);
|
2008-09-15 12:17:15 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_ARRAY_ITER_NEXT
|
2008-09-22 22:17:49 -07:00
|
|
|
* @brief Macro to iterate over an array easily.
|
2008-09-15 12:17:15 -07:00
|
|
|
*
|
|
|
|
* @param array The array to iterate over.
|
|
|
|
* @param index The integer number that is increased while itareting.
|
|
|
|
* @param item The data
|
|
|
|
* @param iterator The iterator
|
|
|
|
*
|
2010-08-09 20:26:15 -07:00
|
|
|
* This macro allows the iteration over @p array in an easy way. It
|
2008-09-17 11:55:54 -07:00
|
|
|
* iterates from the first element to the last one. @p index is an
|
2010-08-09 20:26:15 -07:00
|
|
|
* integer that increases from 0 to the number of elements. @p item is
|
2008-09-15 12:17:15 -07:00
|
|
|
* the data of each element of @p array, so it is a pointer to a type
|
|
|
|
* chosen by the user. @p iterator is of type #Eina_Array_Iterator.
|
|
|
|
*
|
|
|
|
* This macro can be used for freeing the data of an array, like in
|
|
|
|
* the following example:
|
|
|
|
*
|
|
|
|
* @code
|
2009-01-29 15:16:23 -08:00
|
|
|
* Eina_Array *array;
|
|
|
|
* char *item;
|
|
|
|
* Eina_Array_Iterator iterator;
|
|
|
|
* unsigned int i;
|
2008-09-15 12:17:15 -07:00
|
|
|
*
|
|
|
|
* // array is already filled,
|
|
|
|
* // its elements are just duplicated strings,
|
|
|
|
* // EINA_ARRAY_ITER_NEXT will be used to free those strings
|
|
|
|
*
|
|
|
|
* EINA_ARRAY_ITER_NEXT(array, i, item, iterator)
|
|
|
|
* free(item);
|
|
|
|
* @endcode
|
|
|
|
*/
|
2010-10-22 23:41:45 -07:00
|
|
|
#define EINA_ARRAY_ITER_NEXT(array, index, item, iterator) \
|
|
|
|
for (index = 0, iterator = (array)->data; \
|
2010-08-16 08:02:37 -07:00
|
|
|
(index < eina_array_count_get(array)) && ((item = *((iterator)++))); \
|
2010-10-22 23:41:45 -07:00
|
|
|
++(index))
|
2008-08-01 05:26:35 -07:00
|
|
|
|
|
|
|
#include "eina_inline_array.x"
|
|
|
|
|
2008-09-18 22:22:43 -07:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|
|
|
|
|
2008-09-07 12:12:49 -07:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|
|
|
|
|
2008-07-30 09:34:54 -07:00
|
|
|
#endif
|