2011-10-11 21:39:27 -07:00
|
|
|
/*
|
|
|
|
* Linked lists support
|
|
|
|
*
|
|
|
|
* Copyright (C) 2002 Alexandre Julliard
|
|
|
|
* Copyright (C) 2011 Mike McCormack (adapted for Eina)
|
|
|
|
*
|
|
|
|
* 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, write to the Free Software
|
|
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __EINA_CLIST_H__
|
|
|
|
#define __EINA_CLIST_H__
|
|
|
|
|
2011-12-07 04:07:18 -08:00
|
|
|
/**
|
|
|
|
* @defgroup Eina_CList_Group Compact List
|
2014-10-29 14:36:27 -07:00
|
|
|
* @ingroup Eina_Containers_Group
|
2011-12-07 04:07:18 -08:00
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Eina_Clist is a compact (inline) list implementation.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* Elements of this list are members of the structs stored in the list.
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
2012-03-29 04:35:34 -07:00
|
|
|
* Advantages over @ref Eina_List and @ref Eina_Inlist :
|
2014-10-29 14:36:27 -07:00
|
|
|
* - Uses less memory (two machine words per item).
|
|
|
|
* - Allows removing items without knowing which list they're in while using O(1) time.
|
|
|
|
* - Doesn't need to keep updating the head pointer as the list is changed.
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
|
|
|
* Disadvantages:
|
2014-10-29 14:36:27 -07:00
|
|
|
* - O(N) time to calculate the list length.
|
|
|
|
* - Requires one list entry in a struct per list (i.e. it's an inlist).
|
|
|
|
* - Requires a head/tail pointer.
|
|
|
|
* - Needs to know the list head when moving to the next or previous pointer.
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note There's no @c NULL at the end of the list, the last item points to the head.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note List heads must be initialized with EINA_CLIST_INIT or by calling eina_clist_element_init.
|
2011-12-07 04:07:18 -08:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* Define a list as follows:
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @code
|
2011-10-11 21:39:27 -07:00
|
|
|
* struct gadget
|
|
|
|
* {
|
|
|
|
* struct Eina_Clist entry; <-- doesn't have to be the first item in the struct
|
|
|
|
* int a, b;
|
|
|
|
* };
|
|
|
|
*
|
|
|
|
* static Eina_Clist global_gadgets = EINA_CLIST_INIT( global_gadgets );
|
2011-10-13 00:06:54 -07:00
|
|
|
* @endcode
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
|
|
|
* or
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @code
|
2011-10-11 21:39:27 -07:00
|
|
|
* struct some_global_thing
|
|
|
|
* {
|
|
|
|
* Eina_Clist gadgets;
|
|
|
|
* };
|
|
|
|
*
|
|
|
|
* eina_clist_init( &some_global_thing->gadgets );
|
2011-10-13 00:06:54 -07:00
|
|
|
* @endcode
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
|
|
|
* Manipulate it like this:
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @code
|
2011-10-11 21:39:27 -07:00
|
|
|
* eina_clist_add_head( &global_gadgets, &new_gadget->entry );
|
|
|
|
* eina_clist_remove( &new_gadget->entry );
|
|
|
|
* eina_clist_add_after( &some_random_gadget->entry, &new_gadget->entry );
|
2011-10-13 00:06:54 -07:00
|
|
|
* @endcode
|
2011-10-11 21:39:27 -07:00
|
|
|
*
|
|
|
|
* And to iterate over it:
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @code
|
2011-10-11 21:39:27 -07:00
|
|
|
* struct gadget *gadget;
|
|
|
|
* EINA_CLIST_FOR_EACH_ENTRY( gadget, &global_gadgets, struct gadget, entry )
|
|
|
|
* {
|
|
|
|
* ...
|
|
|
|
* }
|
2011-10-13 00:06:54 -07:00
|
|
|
* @endcode
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @typedef Eina_Clist
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Type for #_Eina_Clist structure containing the list head and the list entry.
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
typedef struct _Eina_Clist Eina_Clist;
|
2011-10-13 00:06:54 -07:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @struct _Eina_Clist
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief The structure type for a compact list type.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @note This structure is used as both the list head and the list entry.
|
2014-10-29 14:36:27 -07:00
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
struct _Eina_Clist
|
|
|
|
{
|
2014-03-20 00:35:41 -07:00
|
|
|
Eina_Clist *next; /**< The next entry in the list */
|
|
|
|
Eina_Clist *prev; /**< The previous entry in the list */
|
2011-10-11 21:39:27 -07:00
|
|
|
};
|
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Adds an element after the specified one.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] elem An element in the list
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] to_add The element to add to the list
|
2011-10-13 00:06:54 -07:00
|
|
|
* @pre The list head must be initialized once before adding anything.
|
|
|
|
* @pre The element is not in any list.
|
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note There is no need to initialize an element before adding it to the list.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_add_after(Eina_Clist *elem, Eina_Clist *to_add);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Adds an element before the specified one.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] elem An element in the list
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] to_add The element to add to the list
|
2011-10-13 00:06:54 -07:00
|
|
|
* @pre The list head must be initialized once before adding anything.
|
|
|
|
* @pre The element is not in any list.
|
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note There is no need to initialize an element before adding it to the list.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_add_before(Eina_Clist *elem, Eina_Clist *to_add);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Adds an element to the head of the list.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] list The list
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] elem An element
|
2011-10-13 00:06:54 -07:00
|
|
|
* @pre The list head must be initialized once before adding anything.
|
|
|
|
* @pre The element is not in any list.
|
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note There is no need to initialize an element before adding it to the list.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_add_head(Eina_Clist *list, Eina_Clist *elem);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Adds an element at the tail of the list.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] list The list
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] elem An element
|
2011-10-13 00:06:54 -07:00
|
|
|
* @pre The list head must be initialized once before adding anything.
|
|
|
|
* @pre The element is not in any list.
|
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note There is no need to initialize an element before adding it to the list.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_add_tail(Eina_Clist *list, Eina_Clist *elem);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Inits an (unlinked) element.
|
2017-02-19 22:18:21 -08:00
|
|
|
* @details This function is called on elements that have not been added to the list
|
|
|
|
* so that eina_clist_element_init() works correctly.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] elem An element
|
2011-10-13 00:06:54 -07:00
|
|
|
* @pre The element is not in any list.
|
2014-10-29 14:36:27 -07:00
|
|
|
* @post The element is marked as not being in any list.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @note It is not necessary to call this before adding an element to this list.
|
2014-10-29 14:36:27 -07:00
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_element_init(Eina_Clist *elem);
|
2011-10-12 19:22:18 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Checks whether an element is in a list.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] elem An element
|
2014-03-20 00:35:41 -07:00
|
|
|
* @return TRUE if the element is in a list, else FALSE.
|
2014-10-29 14:36:27 -07:00
|
|
|
* @pre Either eina_clist_element_init() has been called on @p elem,
|
|
|
|
* or it has been added to a list or removed from a list.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline int eina_clist_element_is_linked(Eina_Clist *elem);
|
2011-10-12 19:22:18 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Removes an element from its list.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] elem An element
|
2014-10-29 14:36:27 -07:00
|
|
|
* @pre The element is already in a list.
|
|
|
|
* @post The element is marked as not being in any list.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_remove(Eina_Clist *elem);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Gets the next element.
|
|
|
|
*
|
|
|
|
* @param[in] list The list
|
|
|
|
* @param[in] elem An element
|
|
|
|
* @return The element after @p elem in @p list, otherwise @c NULL if @p elem is last in @p list
|
|
|
|
* @pre @p elem is in @p list.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline Eina_Clist *eina_clist_next(const Eina_Clist *list, const Eina_Clist *elem);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Gets the previous element.
|
|
|
|
*
|
|
|
|
* @param[in] list The list
|
|
|
|
* @param[in] elem An element
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @return The element before @p elem, otherwise @c NULL if @p elem is first in @p list
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline Eina_Clist *eina_clist_prev(const Eina_Clist *list, const Eina_Clist *elem);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Gets the first element.
|
|
|
|
*
|
|
|
|
* @param[in] list The list
|
|
|
|
* @return The first element in @p list, otherwise @c NULL if @p list is empty
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline Eina_Clist *eina_clist_head(const Eina_Clist *list);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Gets the last element.
|
|
|
|
*
|
|
|
|
* @param[in] list The list
|
|
|
|
* @return The last element in @p list, otherwise @c NULL if @p list is empty
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline Eina_Clist *eina_clist_tail(const Eina_Clist *list);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Checks whether a list is empty.
|
|
|
|
*
|
|
|
|
* @param[in] list The list
|
|
|
|
* @return A non-zero value if @p list is empty, otherwise zero if it is not
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline int eina_clist_empty(const Eina_Clist *list);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Initializes a list.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] list The list
|
2011-10-13 00:06:54 -07:00
|
|
|
* @pre The list is uninitialized
|
|
|
|
* @post The list contains no items
|
|
|
|
*
|
|
|
|
* @note Don't call this function on a list with items
|
2014-10-29 14:36:27 -07:00
|
|
|
* @note This function must be called. Don't try to
|
|
|
|
* initialize the list by zeroing out the list head.
|
|
|
|
*
|
2011-10-13 00:06:54 -07:00
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_init(Eina_Clist *list);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Counts the elements of a list.
|
|
|
|
*
|
|
|
|
* @param[in] list The list
|
|
|
|
* @return The number of items in the list
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline unsigned int eina_clist_count(const Eina_Clist *list);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Moves all elements from @p src to the tail of @p dst.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] dst The list to be appended to
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] src The list to append
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @post @p src is initialized, but is empty after this operation.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_move_tail(Eina_Clist *dst, Eina_Clist *src);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Moves all elements from @p src to the head of @p dst.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] dst The list to be prepended to
|
2014-10-29 14:36:27 -07:00
|
|
|
* @param[in] src The list to prepend
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
2014-10-29 14:36:27 -07:00
|
|
|
* @post @p src is initialized, but is empty after this operation.
|
2011-10-13 00:06:54 -07:00
|
|
|
*
|
|
|
|
* @since 1.1.0
|
|
|
|
*/
|
2011-12-06 08:55:50 -08:00
|
|
|
static inline void eina_clist_move_head(Eina_Clist *dst, Eina_Clist *src);
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-10-13 00:06:54 -07:00
|
|
|
/**
|
2012-04-12 10:44:45 -07:00
|
|
|
* @def EINA_CLIST_FOR_EACH
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] cursor The pointer to be used during the interaction
|
|
|
|
* @param[in] list The list to be interacted with
|
2011-10-13 00:06:54 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH(cursor,list) \
|
|
|
|
for ((cursor) = (list)->next; (cursor) != (list); (cursor) = (cursor)->next)
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_SAFE
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list, with safety against removal.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] cursor The pointer to be used during the interaction
|
|
|
|
* @param[out] cursor2 The auxiliary pointer to be used during the interaction
|
|
|
|
* @param[in] list The list to be interacted with
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_SAFE(cursor, cursor2, list) \
|
|
|
|
for ((cursor) = (list)->next, (cursor2) = (cursor)->next; \
|
|
|
|
(cursor) != (list); \
|
|
|
|
(cursor) = (cursor2), (cursor2) = (cursor)->next)
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_ENTRY
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list using a list entry.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] elem The element to be used
|
|
|
|
* @param[in] list The list to be iterated
|
|
|
|
* @param[in] type The type of the list
|
|
|
|
* @param[in] field The field of the element
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_ENTRY(elem, list, type, field) \
|
|
|
|
for ((elem) = EINA_CLIST_ENTRY((list)->next, type, field); \
|
|
|
|
&(elem)->field != (list); \
|
|
|
|
(elem) = EINA_CLIST_ENTRY((elem)->field.next, type, field))
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_ENTRY_SAFE
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list using a list entry, with safety against removal.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] cursor The pointer to be used during the interaction
|
|
|
|
* @param[out] cursor2 The auxiliary pointer to be used during the interaction
|
|
|
|
* @param[in] list The list to be interacted with
|
|
|
|
* @param[in] type The type of the list
|
|
|
|
* @param[in] field The field of the element
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_ENTRY_SAFE(cursor, cursor2, list, type, field) \
|
|
|
|
for ((cursor) = EINA_CLIST_ENTRY((list)->next, type, field), \
|
|
|
|
(cursor2) = EINA_CLIST_ENTRY((cursor)->field.next, type, field); \
|
|
|
|
&(cursor)->field != (list); \
|
|
|
|
(cursor) = (cursor2), \
|
|
|
|
(cursor2) = EINA_CLIST_ENTRY((cursor)->field.next, type, field))
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_REV
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list in the reverse order.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] cursor The pointer to be used during the interaction
|
|
|
|
* @param[in] list The list to be interacted with
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_REV(cursor,list) \
|
|
|
|
for ((cursor) = (list)->prev; (cursor) != (list); (cursor) = (cursor)->prev)
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_SAFE_REV
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list in the reverse order, with safety against removal.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] cursor The pointer to be used during the interaction
|
|
|
|
* @param[out] cursor2 The auxiliary pointer to be used during the interaction
|
|
|
|
* @param[in] list The list to be interacted with
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_SAFE_REV(cursor, cursor2, list) \
|
|
|
|
for ((cursor) = (list)->prev, (cursor2) = (cursor)->prev; \
|
|
|
|
(cursor) != (list); \
|
|
|
|
(cursor) = (cursor2), (cursor2) = (cursor)->prev)
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_ENTRY_REV
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list in the reverse order using a list entry.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] elem The element to be used
|
|
|
|
* @param[in] list The list to be iterated
|
|
|
|
* @param[in] type The type of the list
|
|
|
|
* @param[in] field The field of the element
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_ENTRY_REV(elem, list, type, field) \
|
|
|
|
for ((elem) = EINA_CLIST_ENTRY((list)->prev, type, field); \
|
|
|
|
&(elem)->field != (list); \
|
|
|
|
(elem) = EINA_CLIST_ENTRY((elem)->field.prev, type, field))
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_FOR_EACH_ENTRY_SAFE_REV
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Iterates through the list in the reverse order using a list entry, with safety against
|
|
|
|
* removal.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] cursor The pointer to be used during the interaction
|
|
|
|
* @param[out] cursor2 The auxiliary pointer to be used during the interaction
|
|
|
|
* @param[in] list The list to be interacted with
|
|
|
|
* @param[in] type The type of the list
|
|
|
|
* @param[in] field The field of the element
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#define EINA_CLIST_FOR_EACH_ENTRY_SAFE_REV(cursor, cursor2, list, type, field) \
|
|
|
|
for ((cursor) = EINA_CLIST_ENTRY((list)->prev, type, field), \
|
|
|
|
(cursor2) = EINA_CLIST_ENTRY((cursor)->field.prev, type, field); \
|
|
|
|
&(cursor)->field != (list); \
|
|
|
|
(cursor) = (cursor2), \
|
|
|
|
(cursor2) = EINA_CLIST_ENTRY((cursor)->field.prev, type, field))
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_INIT
|
|
|
|
* @brief Macros for statically initialized lists.
|
2014-10-29 14:36:27 -07:00
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[in,out] list The list to be used
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#undef EINA_CLIST_INIT
|
|
|
|
#define EINA_CLIST_INIT(list) { &(list), &(list) }
|
|
|
|
|
2012-04-12 10:44:45 -07:00
|
|
|
/**
|
|
|
|
* @def EINA_CLIST_ENTRY
|
2014-10-29 14:36:27 -07:00
|
|
|
* @brief Gets a pointer to the object containing the list element.
|
|
|
|
*
|
2018-03-26 16:03:42 -07:00
|
|
|
* @param[out] elem The element to be used
|
|
|
|
* @param[in] type The type of the element
|
|
|
|
* @param[in] field The field of the element
|
2012-04-12 10:44:45 -07:00
|
|
|
*/
|
2011-10-11 21:39:27 -07:00
|
|
|
#undef EINA_CLIST_ENTRY
|
|
|
|
#define EINA_CLIST_ENTRY(elem, type, field) \
|
2013-02-16 01:54:36 -08:00
|
|
|
((type *)((char *)(elem) - (uintptr_t)(&((type *)0)->field)))
|
2011-10-11 21:39:27 -07:00
|
|
|
|
2011-12-06 08:55:50 -08:00
|
|
|
#include "eina_inline_clist.x"
|
|
|
|
|
2011-12-07 04:07:18 -08:00
|
|
|
/**
|
2011-10-13 00:06:54 -07:00
|
|
|
* @}
|
|
|
|
*/
|
|
|
|
|
2011-10-11 21:39:27 -07:00
|
|
|
#endif /* __EINA_CLIST_H__ */
|