From: caro Date: Fri, 28 May 2010 19:03:26 +0000 (+0000) Subject: do not declare inlined functions in the source file, X-Git-Tag: submit/2.0alpha-wayland/20121127.222009~1166 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=aebc54eeb6b38adf10a2d54dbf1ac819358ca7a2;p=profile%2Fivi%2Feina.git do not declare inlined functions in the source file, fix a bit the doc of inlined functions git-svn-id: http://svn.enlightenment.org/svn/e/trunk/eina@49253 7cbeb6ba-43b4-40fd-8cce-4c39aea84d33 --- diff --git a/src/include/eina_inline_list.x b/src/include/eina_inline_list.x index 43b3869..5c77d96 100644 --- a/src/include/eina_inline_list.x +++ b/src/include/eina_inline_list.x @@ -27,6 +27,18 @@ * @{ */ +/** + * @brief Get the last list node in the list. + * + * @param list The list to get the last list node from. + * @return The last list node in the list. + * + * This function returns the last list node in the list @p list. If + * @p list is @c NULL or empty, @c NULL is returned. + * + * This is a order-1 operation (it takes the same short time + * regardless of the length of the list). + */ static inline Eina_List * eina_list_last(const Eina_List *list) { @@ -34,6 +46,16 @@ eina_list_last(const Eina_List *list) return list->accounting->last; } +/** + * @brief Get the next list node after the specified list node. + * + * @param list The list node to get the next list node from + * @return The next list node on success, @c NULL otherwise. + * + * This function returns the next list node after the current one in + * @p list. It is equivalent to list->next. If @p list is @c NULL or + * if no next list node exists, it returns @c NULL. + */ static inline Eina_List * eina_list_next(const Eina_List *list) { @@ -41,6 +63,17 @@ eina_list_next(const Eina_List *list) return list->next; } +/** + * @brief Get the previous list node before the specified list node. + * + * @param list The list node to get the previous list node from. + * @return The previous list node o success, @c NULL otherwise. + * if no previous list node exists + * + * This function returns the previous list node before the current one + * in @p list. It is equivalent to list->prev. If @p list is @c NULL or + * if no previous list node exists, it returns @c NULL. + */ static inline Eina_List * eina_list_prev(const Eina_List *list) { @@ -48,6 +81,16 @@ eina_list_prev(const Eina_List *list) return list->prev; } +/** + * @brief Get the list node data member. + * + * @param list The list node to get the data member of. + * @return The data member from the list node. + * + * This function returns the data member of the specified list node @p + * list. It is equivalent to list->data. If @p list is @c NULL, this + * function returns @c NULL. + */ static inline void * eina_list_data_get(const Eina_List *list) { @@ -55,6 +98,17 @@ eina_list_data_get(const Eina_List *list) return list->data; } +/** + * @brief Set the list node data member. + * + * @param list The list node to get the data member of. + * @param data The data member to the list node. + * @return The previous data value. + * + * This function set the data member @p data of the specified list node + * @p list. It returns the previous data of the node. If @p list is + * @c NULL, this function returns @c NULL. + */ static inline void * eina_list_data_set(Eina_List *list, const void *data) { @@ -65,6 +119,18 @@ eina_list_data_set(Eina_List *list, const void *data) return tmp; } +/** + * @brief Get the count of the number of items in a list. + * + * @param list The list whose count to return. + * @return The number of members in the list. + * + * This function returns how many members @p list contains. If the + * list is @c NULL, 0 is returned. + * + * NB: This is an order-1 operation and takes the same tiem regardless + * of the length of the list. + */ static inline unsigned int eina_list_count(const Eina_List *list) { diff --git a/src/lib/eina_list.c b/src/lib/eina_list.c index 1c276dc..3d5d047 100644 --- a/src/lib/eina_list.c +++ b/src/lib/eina_list.c @@ -1241,71 +1241,6 @@ eina_list_nth_list(const Eina_List *list, unsigned int n) } /** - * @brief Get the last list node in the list. - * - * @param list The list to get the last list node from. - * @return The last list node in the list. - * - * This function returns the last list node in the list. If @p list is - * @c NULL or empty, @c NULL is returned. - * - * This is a order-1 operation (it takes the same short time - * regardless of the length of the list). - */ -static inline Eina_List *eina_list_last(const Eina_List *list); - -/** - * @brief Get the next list node after the specified list node. - * - * @param list The list node to get the next list node from - * @return The next list node on success, @c NULL otherwise. - * - * This function returns the next list node after the current one in - * @p list. It is equivalent to list->next. If @p list is @c NULL or - * if no next list node exists, it returns @c NULL. - */ -static inline Eina_List *eina_list_next(const Eina_List *list); - -/** - * @brief Get the previous list node before the specified list node. - * - * @param list The list node to get the previous list node from. - * @return The previous list node o success, @c NULL otherwise. - * if no previous list node exists - * - * This function returns the previous list node before the current one - * in @p list. It is equivalent to list->prev. If @p list is @c NULL or - * if no previous list node exists, it returns @c NULL. - */ -static inline Eina_List *eina_list_prev(const Eina_List *list); - -/** - * @brief Get the list node data member. - * - * @param list The list node to get the data member of. - * @return The data member from the list node. - * - * This function returns the data member of the specified list node @p - * list. It is equivalent to list->data. If @p list is @c NULL, this - * function returns @c NULL. - */ -static inline void *eina_list_data_get(const Eina_List *list); - -/** - * @brief Get the count of the number of items in a list. - * - * @param list The list whose count to return. - * @return The number of members in the list. - * - * This function returns how many members @p list contains. If the - * list is @c NULL, 0 is returned. - * - * NB: This is an order-1 operation and takes the same tiem regardless - * of the length of the list. - */ -static inline unsigned int eina_list_count(const Eina_List *list); - -/** * @brief Reverse all the elements in the list. * * @param list The list to reverse.