forked from enlightenment/efl
192 lines
5.2 KiB
C
192 lines
5.2 KiB
C
/* EINA - EFL data type library
|
|
* Copyright (C) 2002-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/>.
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
# include "config.h"
|
|
#endif
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include "eina_config.h"
|
|
#include "eina_private.h"
|
|
|
|
/* undefs EINA_ARG_NONULL() so NULL checks are not compiled out! */
|
|
#include "eina_safety_checks.h"
|
|
#include "eina_accessor.h"
|
|
|
|
/*============================================================================*
|
|
* Local *
|
|
*============================================================================*/
|
|
|
|
/**
|
|
* @cond LOCAL
|
|
*/
|
|
|
|
static const char EINA_MAGIC_ACCESSOR_STR[] = "Eina Accessor";
|
|
|
|
#define EINA_MAGIC_CHECK_ACCESSOR(d) \
|
|
do { \
|
|
if (!EINA_MAGIC_CHECK(d, EINA_MAGIC_ACCESSOR)) { \
|
|
EINA_MAGIC_FAIL(d, EINA_MAGIC_ACCESSOR); } \
|
|
} while(0)
|
|
|
|
/**
|
|
* @endcond
|
|
*/
|
|
|
|
/*============================================================================*
|
|
* Global *
|
|
*============================================================================*/
|
|
|
|
/**
|
|
* @internal
|
|
* @brief Initialize the accessor module.
|
|
*
|
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
|
*
|
|
* This function sets up the accessor module of Eina. It is called by
|
|
* eina_init().
|
|
*
|
|
* @see eina_init()
|
|
*/
|
|
Eina_Bool
|
|
eina_accessor_init(void)
|
|
{
|
|
return eina_magic_string_set(EINA_MAGIC_ACCESSOR, EINA_MAGIC_ACCESSOR_STR);
|
|
}
|
|
|
|
/**
|
|
* @internal
|
|
* @brief Shut down the accessor module.
|
|
*
|
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
|
*
|
|
* This function shuts down the accessor module set up by
|
|
* eina_accessor_init(). It is called by eina_shutdown().
|
|
*
|
|
* @see eina_shutdown()
|
|
*/
|
|
Eina_Bool
|
|
eina_accessor_shutdown(void)
|
|
{
|
|
return EINA_TRUE;
|
|
}
|
|
|
|
/*============================================================================*
|
|
* API *
|
|
*============================================================================*/
|
|
|
|
|
|
EAPI void
|
|
eina_accessor_free(Eina_Accessor *accessor)
|
|
{
|
|
if (!accessor)
|
|
return;
|
|
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN(accessor->free);
|
|
accessor->free(accessor);
|
|
}
|
|
|
|
EAPI void *
|
|
eina_accessor_container_get(Eina_Accessor *accessor)
|
|
{
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor, NULL);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor->get_container, NULL);
|
|
return accessor->get_container(accessor);
|
|
}
|
|
|
|
EAPI Eina_Bool
|
|
eina_accessor_data_get(Eina_Accessor *accessor,
|
|
unsigned int position,
|
|
void **data)
|
|
{
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor, EINA_FALSE);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor->get_at, EINA_FALSE);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(data, EINA_FALSE);
|
|
return accessor->get_at(accessor, position, data);
|
|
}
|
|
|
|
EAPI void
|
|
eina_accessor_over(Eina_Accessor *accessor,
|
|
Eina_Each_Cb cb,
|
|
unsigned int start,
|
|
unsigned int end,
|
|
const void *fdata)
|
|
{
|
|
const void *container;
|
|
void *data;
|
|
unsigned int i;
|
|
|
|
if (!accessor) return;
|
|
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN(accessor->get_container);
|
|
EINA_SAFETY_ON_NULL_RETURN(accessor->get_at);
|
|
EINA_SAFETY_ON_NULL_RETURN(cb);
|
|
EINA_SAFETY_ON_FALSE_RETURN(start < end);
|
|
|
|
if (!eina_accessor_lock(accessor))
|
|
return;
|
|
|
|
container = accessor->get_container(accessor);
|
|
for (i = start; i < end && accessor->get_at(accessor, i, &data) == EINA_TRUE;
|
|
++i)
|
|
if (cb(container, data, (void *)fdata) != EINA_TRUE)
|
|
goto on_exit;
|
|
|
|
on_exit:
|
|
(void) eina_accessor_unlock(accessor);
|
|
}
|
|
|
|
EAPI Eina_Bool
|
|
eina_accessor_lock(Eina_Accessor *accessor)
|
|
{
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor, EINA_FALSE);
|
|
|
|
if (accessor->lock)
|
|
return accessor->lock(accessor);
|
|
return EINA_TRUE;
|
|
}
|
|
|
|
EAPI Eina_Accessor*
|
|
eina_accessor_clone(Eina_Accessor *accessor)
|
|
{
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor, NULL);
|
|
|
|
if (accessor->clone)
|
|
return accessor->clone(accessor);
|
|
|
|
return NULL;
|
|
}
|
|
|
|
EAPI Eina_Bool
|
|
eina_accessor_unlock(Eina_Accessor *accessor)
|
|
{
|
|
EINA_MAGIC_CHECK_ACCESSOR(accessor);
|
|
EINA_SAFETY_ON_NULL_RETURN_VAL(accessor, EINA_FALSE);
|
|
|
|
if (accessor->unlock)
|
|
return accessor->unlock(accessor);
|
|
return EINA_TRUE;
|
|
}
|