+eina_list_move* for moving list node data to another list

git-svn-id: svn+ssh://svn.enlightenment.org/var/svn/e/trunk/eina@57110 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33

diff --git a/ChangeLog b/ChangeLog
index fdd1d0f..c36045e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -18,3 +18,7 @@
 
        * Added eina_unicode_utf8* functions for utf8 string handling
        and conversions to and from Eina_Unicode
+
+2011-02-17  Mike Blumenkrantz
+
+        * Added eina_list_move* functions for moving list node data to other lists

diff --git a/src/include/eina_list.h b/src/include/eina_list.h
index e19d67d..5a750d1 100644 (file)
--- a/src/include/eina_list.h
+++ b/src/include/eina_list.h
@@ -110,6 +110,10 @@ EAPI Eina_List            *eina_list_demote_list(Eina_List *list, Eina_List *mov
 
 EAPI void                 *eina_list_data_find(const Eina_List *list, const void *data) EINA_PURE EINA_ARG_NONNULL(2) EINA_WARN_UNUSED_RESULT;
 EAPI Eina_List            *eina_list_data_find_list(const Eina_List *list, const void *data) EINA_PURE EINA_ARG_NONNULL(2) EINA_WARN_UNUSED_RESULT;
+
+EAPI Eina_Bool             eina_list_move(Eina_List **to, Eina_List **from, void *data);
+EAPI Eina_Bool             eina_list_move_list(Eina_List **to, Eina_List **from, Eina_List *data);
+
 EAPI Eina_List            *eina_list_free(Eina_List *list);
 
 EAPI void                 *eina_list_nth(const Eina_List *list, unsigned int n) EINA_PURE EINA_WARN_UNUSED_RESULT;

diff --git a/src/lib/eina_list.c b/src/lib/eina_list.c
index f3a4710..fb59aae 100644 (file)
--- a/src/lib/eina_list.c
+++ b/src/lib/eina_list.c
@@ -1201,6 +1201,65 @@ eina_list_data_find(const Eina_List *list, const void *data)
 }
 
 /**
+ * @brief Move a data pointer from one list to another
+ *
+ * @param to The list to move the data to
+ * @param from The list to move from
+ * @param data The data to move
+ * @return #EINA_TRUE on success, else #EINA_FALSE
+ *
+ * This function is a shortcut for doing the following:
+ * to = eina_list_append(to, data);
+ * from = eina_list_remove(from, data);
+ */
+EAPI Eina_Bool
+eina_list_move(Eina_List **to, Eina_List **from, void *data)
+{
+   Eina_List *l;
+   
+   EINA_SAFETY_ON_NULL_RETURN_VAL(to, EINA_FALSE);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(from, EINA_FALSE);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(data, EINA_FALSE);
+   
+   EINA_MAGIC_CHECK_LIST(*to, EINA_FALSE);
+   EINA_MAGIC_CHECK_LIST(*from, EINA_FALSE);
+
+   l = eina_list_data_find_list(*from, data);
+   if (!l) return EINA_FALSE; /* should this be SAFETY_ON_NULL for a warning? */
+
+   *to = eina_list_append(*to, data);
+   *from = eina_list_remove_list(*from, l);
+   return EINA_TRUE;
+}
+
+/**
+ * @brief Move a list node from one list to another
+ *
+ * @param to The list to move the data to
+ * @param from The list to move from
+ * @param data The list node containing the data to move
+ * @return #EINA_TRUE on success, else #EINA_FALSE
+ *
+ * This function is a shortcut for doing the following:
+ * to = eina_list_append(to, data->data);
+ * from = eina_list_remove_list(from, data);
+ */
+EAPI Eina_Bool
+eina_list_move_list(Eina_List **to, Eina_List **from, Eina_List *data)
+{
+   EINA_SAFETY_ON_NULL_RETURN_VAL(to, EINA_FALSE);
+   EINA_SAFETY_ON_NULL_RETURN_VAL(from, EINA_FALSE);
+   
+   EINA_MAGIC_CHECK_LIST(*to, EINA_FALSE);
+   EINA_MAGIC_CHECK_LIST(*from, EINA_FALSE);
+   EINA_MAGIC_CHECK_LIST(data, EINA_FALSE);
+
+   *to = eina_list_append(*to, data->data);
+   *from = eina_list_remove_list(*from, data);
+   return EINA_TRUE;
+}
+
+/**
  * @brief Find a member of a list and return the list node containing that member.
  *
  * @param list The list to search for data.