forked from enlightenment/efl
eina: doxygen doc fixes
A #link at the beginning of a new line goes interpreted by doxygen as a title, so format the documentation to avoid this issue. No content change. SVN revision: 71501
This commit is contained in:
parent
054360207b
commit
b3e92d38b0
|
@ -203,8 +203,8 @@ EAPI void eina_accessor_free(Eina_Accessor *accessor) EINA_ARG_NONNULL(1);
|
||||||
*
|
*
|
||||||
* This function retrieves the data of the element pointed by
|
* This function retrieves the data of the element pointed by
|
||||||
* @p accessor at the porition @p position, and stores it in
|
* @p accessor at the porition @p position, and stores it in
|
||||||
* @p data. If @p accessor is @c NULL or if an error occurred,
|
* @p data. If @p accessor is @c NULL or if an error occurred, #EINA_FALSE
|
||||||
* #EINA_FALSE is returned, otherwise EINA_TRUE is returned.
|
* is returned, otherwise #EINA_TRUE is returned.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eina_accessor_data_get(Eina_Accessor *accessor,
|
EAPI Eina_Bool eina_accessor_data_get(Eina_Accessor *accessor,
|
||||||
unsigned int position,
|
unsigned int position,
|
||||||
|
|
|
@ -253,8 +253,8 @@ struct _Eina_Array
|
||||||
* another element will increase the buffer by @p step elements again.
|
* another element will increase the buffer by @p step elements again.
|
||||||
*
|
*
|
||||||
* This function return a valid array on success, or @c NULL if memory
|
* This function return a valid array on success, or @c NULL if memory
|
||||||
* allocation fails. In that case, the error is set to
|
* allocation fails. In that case, the error is set
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY.
|
* to #EINA_ERROR_OUT_OF_MEMORY.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Array *eina_array_new(unsigned int step) EINA_WARN_UNUSED_RESULT EINA_MALLOC EINA_WARN_UNUSED_RESULT;
|
EAPI Eina_Array *eina_array_new(unsigned int step) EINA_WARN_UNUSED_RESULT EINA_MALLOC EINA_WARN_UNUSED_RESULT;
|
||||||
|
|
||||||
|
@ -265,8 +265,8 @@ EAPI Eina_Array *eina_array_new(unsigned int step) EINA_WARN_UNUSED_RESULT EINA_
|
||||||
*
|
*
|
||||||
* This function frees @p array. It calls first eina_array_flush() then
|
* This function frees @p array. It calls first eina_array_flush() then
|
||||||
* free the memory of the pointer. It does not free the memory
|
* free the memory of the pointer. It does not free the memory
|
||||||
* allocated for the elements of @p array. To free them, use
|
* allocated for the elements of @p array. To free them,
|
||||||
* #EINA_ARRAY_ITER_NEXT. For performance reasons, there is no check
|
* use #EINA_ARRAY_ITER_NEXT. For performance reasons, there is no check
|
||||||
* of @p array.
|
* of @p array.
|
||||||
*/
|
*/
|
||||||
EAPI void eina_array_free(Eina_Array *array) EINA_ARG_NONNULL(1);
|
EAPI void eina_array_free(Eina_Array *array) EINA_ARG_NONNULL(1);
|
||||||
|
|
|
@ -365,8 +365,8 @@ typedef void (*Eina_Benchmark_Specimens)(int request);
|
||||||
* to name the gnuplot file that eina_benchmark_run() will create.
|
* to name the gnuplot file that eina_benchmark_run() will create.
|
||||||
*
|
*
|
||||||
* This function return a valid benchmark on success, or @c NULL if
|
* This function return a valid benchmark on success, or @c NULL if
|
||||||
* memory allocation fails. In that case, the error is set to
|
* memory allocation fails. In that case, the error is set
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY.
|
* to #EINA_ERROR_OUT_OF_MEMORY.
|
||||||
*
|
*
|
||||||
* When the new module is not needed anymore, use
|
* When the new module is not needed anymore, use
|
||||||
* eina_benchmark_free() to free the allocated memory.
|
* eina_benchmark_free() to free the allocated memory.
|
||||||
|
|
|
@ -115,8 +115,8 @@ EAPI Eina_Bool eina_binbuf_append_length(Eina_Binbuf *buf, const unsigned char *
|
||||||
* @param c The char to append.
|
* @param c The char to append.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This function inserts @p c to @p buf. If it can not insert it,
|
* This function inserts @p c to @p buf. If it can not insert it, #EINA_FALSE
|
||||||
* #EINA_FALSE is returned, otherwise #EINA_TRUE is returned.
|
* is returned, otherwise #EINA_TRUE is returned.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eina_binbuf_append_char(Eina_Binbuf *buf, unsigned char c) EINA_ARG_NONNULL(1);
|
EAPI Eina_Bool eina_binbuf_append_char(Eina_Binbuf *buf, unsigned char c) EINA_ARG_NONNULL(1);
|
||||||
|
|
||||||
|
|
|
@ -329,8 +329,8 @@ typedef Eina_Bool (*Eina_Hash_Foreach)(const Eina_Hash *hash, const void *key
|
||||||
* @return The new hash table.
|
* @return The new hash table.
|
||||||
*
|
*
|
||||||
* This function creates a new hash table using user-defined callbacks
|
* This function creates a new hash table using user-defined callbacks
|
||||||
* to manage the hash table. On failure, @c NULL is returned and
|
* to manage the hash table. On failure, @c NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. If @p key_cmp_cb or @p key_hash_cb
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. If @p key_cmp_cb or @p key_hash_cb
|
||||||
* are @c NULL, @c NULL is returned. If @p buckets_power_size is
|
* are @c NULL, @c NULL is returned. If @p buckets_power_size is
|
||||||
* smaller or equal than 2, or if it is greater or equal than 17,
|
* smaller or equal than 2, or if it is greater or equal than 17,
|
||||||
* @c NULL is returned.
|
* @c NULL is returned.
|
||||||
|
@ -561,8 +561,8 @@ EAPI Eina_Bool eina_hash_direct_add(Eina_Hash *hash,
|
||||||
* This function removes the entry identified by @p key or @p data
|
* This function removes the entry identified by @p key or @p data
|
||||||
* from @p hash. If a free function was given to the
|
* from @p hash. If a free function was given to the
|
||||||
* callback on creation, it will be called for the data being
|
* callback on creation, it will be called for the data being
|
||||||
* deleted. If @p hash is @c NULL, the functions returns immediately
|
* deleted. If @p hash is @c NULL, the functions returns immediately #EINA_FALSE.
|
||||||
* #EINA_FALSE. If @p key is @c NULL, then @p data is used to find the a
|
* If @p key is @c NULL, then @p data is used to find the a
|
||||||
* match to remove, otherwise @p key is used and @p data is not
|
* match to remove, otherwise @p key is used and @p data is not
|
||||||
* required and can be @c NULL. This function returns #EINA_FALSE if
|
* required and can be @c NULL. This function returns #EINA_FALSE if
|
||||||
* an error occurred, #EINA_TRUE otherwise.
|
* an error occurred, #EINA_TRUE otherwise.
|
||||||
|
@ -778,8 +778,8 @@ EAPI Eina_Bool eina_hash_direct_add_by_hash(Eina_Hash *hash,
|
||||||
* callback on creation, it will be called for the data being
|
* callback on creation, it will be called for the data being
|
||||||
* deleted. Do not forget to count '\\0' for string when setting the
|
* deleted. Do not forget to count '\\0' for string when setting the
|
||||||
* value of @p key_length. If @p hash or @p key are @c NULL, the
|
* value of @p key_length. If @p hash or @p key are @c NULL, the
|
||||||
* functions returns immediately #EINA_FALSE. This function returns
|
* functions returns immediately #EINA_FALSE. This function
|
||||||
* #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
|
* returns #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
|
||||||
*
|
*
|
||||||
* @note if you don't have the key_hash, use eina_hash_del_by_key() instead.
|
* @note if you don't have the key_hash, use eina_hash_del_by_key() instead.
|
||||||
* @note if you don't have the key, use eina_hash_del_by_data() instead.
|
* @note if you don't have the key, use eina_hash_del_by_data() instead.
|
||||||
|
@ -804,8 +804,8 @@ EAPI Eina_Bool eina_hash_del_by_key_hash(Eina_Hash *hash,
|
||||||
* using functiond provided to has creation function. If a free
|
* using functiond provided to has creation function. If a free
|
||||||
* function was given to the callback on creation, it will be called
|
* function was given to the callback on creation, it will be called
|
||||||
* for the data being deleted. If @p hash or @p key are @c NULL, the
|
* for the data being deleted. If @p hash or @p key are @c NULL, the
|
||||||
* functions returns immediately #EINA_FALSE. This function returns
|
* functions returns immediately #EINA_FALSE. This function
|
||||||
* #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
|
* returns #EINA_FALSE if an error occurred, #EINA_TRUE otherwise.
|
||||||
*
|
*
|
||||||
* @note if you already have the key_hash, use eina_hash_del_by_key_hash()
|
* @note if you already have the key_hash, use eina_hash_del_by_key_hash()
|
||||||
* instead.
|
* instead.
|
||||||
|
@ -854,8 +854,8 @@ EAPI Eina_Bool eina_hash_del_by_data(Eina_Hash *hash,
|
||||||
* This function removes the entry identified by @p key and
|
* This function removes the entry identified by @p key and
|
||||||
* @p key_hash, or @p data, from @p hash. If a free function was given to
|
* @p key_hash, or @p data, from @p hash. If a free function was given to
|
||||||
* the callback on creation, it will be called for the data being
|
* the callback on creation, it will be called for the data being
|
||||||
* deleted. If @p hash is @c NULL, the functions returns immediately
|
* deleted. If @p hash is @c NULL, the functions returns immediately #EINA_FALSE.
|
||||||
* #EINA_FALSE. If @p key is @c NULL, then @p key_length and @p key_hash
|
* If @p key is @c NULL, then @p key_length and @p key_hash
|
||||||
* are ignored and @p data is used to find a match to remove,
|
* are ignored and @p data is used to find a match to remove,
|
||||||
* otherwise @p key and @p key_hash are used and @p data is not
|
* otherwise @p key and @p key_hash are used and @p data is not
|
||||||
* required and can be @c NULL. Do not forget to count '\\0' for
|
* required and can be @c NULL. Do not forget to count '\\0' for
|
||||||
|
@ -926,8 +926,8 @@ EAPI void *eina_hash_modify_by_hash(Eina_Hash *hash,
|
||||||
* valid iterator that will always return false on
|
* valid iterator that will always return false on
|
||||||
* eina_iterator_next(), thus keeping API sane.
|
* eina_iterator_next(), thus keeping API sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the hash structure changes then the iterator becomes
|
* @warning if the hash structure changes then the iterator becomes
|
||||||
|
@ -947,8 +947,8 @@ EAPI Eina_Iterator *eina_hash_iterator_key_new(const Eina_Hash *hash) EINA_MALLO
|
||||||
* valid iterator that will always return false on
|
* valid iterator that will always return false on
|
||||||
* eina_iterator_next(), thus keeping API sane.
|
* eina_iterator_next(), thus keeping API sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, @c NULL is returned and
|
* If the memory can not be allocated, @c NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the hash structure changes then the iterator becomes
|
* @warning if the hash structure changes then the iterator becomes
|
||||||
|
@ -968,8 +968,8 @@ EAPI Eina_Iterator *eina_hash_iterator_data_new(const Eina_Hash *hash) EINA_MALL
|
||||||
* valid iterator that will always return false on
|
* valid iterator that will always return false on
|
||||||
* eina_iterator_next(), thus keeping API sane.
|
* eina_iterator_next(), thus keeping API sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @note iterator data will provide values as Eina_Hash_Tuple that should not
|
* @note iterator data will provide values as Eina_Hash_Tuple that should not
|
||||||
|
|
|
@ -558,10 +558,9 @@ EAPI int eina_inarray_search_sorted(const Eina_Inarray *array,
|
||||||
*
|
*
|
||||||
* Call @a function for every given data in @a array.
|
* Call @a function for every given data in @a array.
|
||||||
*
|
*
|
||||||
* Safe way to iterate over an array. @p function should return
|
* Safe way to iterate over an array. @p function should return #EINA_TRUE
|
||||||
* #EINA_TRUE as long as you want the function to continue iterating,
|
* as long as you want the function to continue iterating, by
|
||||||
* by returning #EINA_FALSE it will stop and return #EINA_FALSE as a
|
* returning #EINA_FALSE it will stop and return #EINA_FALSE as a result.
|
||||||
* result.
|
|
||||||
*
|
*
|
||||||
* The data given to @a function are the pointer to member memory
|
* The data given to @a function are the pointer to member memory
|
||||||
* itself.
|
* itself.
|
||||||
|
@ -607,8 +606,8 @@ EAPI unsigned int eina_inarray_count(const Eina_Inarray *array) EINA_ARG_NONNULL
|
||||||
* This function returns a newly allocated iterator associated to
|
* This function returns a newly allocated iterator associated to
|
||||||
* @p array.
|
* @p array.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the array structure changes then the iterator becomes
|
* @warning if the array structure changes then the iterator becomes
|
||||||
|
@ -629,8 +628,8 @@ EAPI Eina_Iterator *eina_inarray_iterator_new(const Eina_Inarray *array) EINA_MA
|
||||||
*
|
*
|
||||||
* Unlike eina_inarray_iterator_new(), this will walk the array backwards.
|
* Unlike eina_inarray_iterator_new(), this will walk the array backwards.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the array structure changes then the iterator becomes
|
* @warning if the array structure changes then the iterator becomes
|
||||||
|
@ -649,8 +648,8 @@ EAPI Eina_Iterator *eina_inarray_iterator_reversed_new(const Eina_Inarray *array
|
||||||
* This function returns a newly allocated accessor associated to
|
* This function returns a newly allocated accessor associated to
|
||||||
* @p array.
|
* @p array.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid accessor is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid accessor is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
|
|
@ -51,8 +51,8 @@ EAPI Eina_Bool eina_array_grow(Eina_Array *array);
|
||||||
* This function appends @p data to @p array. For performance
|
* This function appends @p data to @p array. For performance
|
||||||
* reasons, there is no check of @p array. If it is @c NULL or
|
* reasons, there is no check of @p array. If it is @c NULL or
|
||||||
* invalid, the program may crash. If @p data is @c NULL, or if an
|
* invalid, the program may crash. If @p data is @c NULL, or if an
|
||||||
* allocation is necessary and fails, #EINA_FALSE is returned and
|
* allocation is necessary and fails, #EINA_FALSE is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, #EINA_TRUE is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, #EINA_TRUE is
|
||||||
* returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|
|
@ -56,8 +56,8 @@ typedef void *Eina_Semaphore;
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function creates a new #Eina_Lock object and stores it in the
|
* This function creates a new #Eina_Lock object and stores it in the
|
||||||
* @p mutex buffer. On success, this function returns #EINA_TRUE and
|
* @p mutex buffer. On success, this function returns #EINA_TRUE
|
||||||
* #EINA_FALSE otherwise. To free the resources allocated by this
|
* and #EINA_FALSE otherwise. To free the resources allocated by this
|
||||||
* function, use eina_lock_free(). For performance reasons, no check
|
* function, use eina_lock_free(). For performance reasons, no check
|
||||||
* is done on @p mutex.
|
* is done on @p mutex.
|
||||||
*/
|
*/
|
||||||
|
@ -88,8 +88,8 @@ eina_lock_free(Eina_Lock *mutex EINA_UNUSED)
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function locks @p mutex. @p mutex must have been created by
|
* This function locks @p mutex. @p mutex must have been created by
|
||||||
* eina_lock_new(). On success, this function returns #EINA_TRUE and
|
* eina_lock_new(). On success, this function returns #EINA_TRUE
|
||||||
* #EINA_FALSE otherwise. For performance reasons, no check is done on
|
* and #EINA_FALSE otherwise. For performance reasons, no check is done on
|
||||||
* @p mutex.
|
* @p mutex.
|
||||||
*/
|
*/
|
||||||
static inline Eina_Lock_Result
|
static inline Eina_Lock_Result
|
||||||
|
@ -105,8 +105,8 @@ eina_lock_take(Eina_Lock *mutex EINA_UNUSED)
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function tries to lock @p mutex. @p mutex must have been created by
|
* This function tries to lock @p mutex. @p mutex must have been created by
|
||||||
* eina_lock_new(). If @p mutex can be locked, this function returns
|
* eina_lock_new(). If @p mutex can be locked, this function returns #EINA_TRUE;
|
||||||
* #EINA_TRUE; if @p mutex can not be locked, or is already locked, it
|
* if @p mutex can not be locked, or is already locked, it
|
||||||
* returns #EINA_FALSE. This function does not block and returns
|
* returns #EINA_FALSE. This function does not block and returns
|
||||||
* immediately. For performance reasons, no check is done on
|
* immediately. For performance reasons, no check is done on
|
||||||
* @p mutex.
|
* @p mutex.
|
||||||
|
@ -126,9 +126,9 @@ eina_lock_take_try(Eina_Lock *mutex EINA_UNUSED)
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function unlocks @p mutex. @p mutex must have been created by
|
* This function unlocks @p mutex. @p mutex must have been created by
|
||||||
* eina_lock_new(). On success, this function returns #EINA_TRUE and
|
* eina_lock_new(). On success, this function returns #EINA_TRUE
|
||||||
* #EINA_FALSE otherwise. For performance reasons, no check is done on
|
* and #EINA_FALSE otherwise. For performance reasons, no check is
|
||||||
* @p mutex.
|
* done on @p mutex.
|
||||||
*/
|
*/
|
||||||
static inline Eina_Lock_Result
|
static inline Eina_Lock_Result
|
||||||
eina_lock_release(Eina_Lock *mutex EINA_UNUSED)
|
eina_lock_release(Eina_Lock *mutex EINA_UNUSED)
|
||||||
|
|
|
@ -36,8 +36,8 @@
|
||||||
* @param l2 The length of the second span.
|
* @param l2 The length of the second span.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
* @return #EINA_TRUE on success, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function returns #EINA_TRUE if the given spans intersect,
|
* This function returns #EINA_TRUE if the given spans intersect, #EINA_FALSE
|
||||||
* #EINA_FALSE otherwise.
|
* otherwise.
|
||||||
*/
|
*/
|
||||||
static inline int
|
static inline int
|
||||||
eina_spans_intersect(int c1, int l1, int c2, int l2)
|
eina_spans_intersect(int c1, int l1, int c2, int l2)
|
||||||
|
@ -90,9 +90,9 @@ eina_rectangle_coords_from(Eina_Rectangle *r, int x, int y, int w, int h)
|
||||||
* @param r2 The second rectangle.
|
* @param r2 The second rectangle.
|
||||||
* @return #EINA_TRUE if the rectangles intersect, #EINA_FALSE otherwise.
|
* @return #EINA_TRUE if the rectangles intersect, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* This function returns #EINA_TRUE if @p r1 and @p r2 intersect,
|
* This function returns #EINA_TRUE if @p r1 and @p r2 intersect, #EINA_FALSE
|
||||||
* #EINA_FALSE otherwise. No check is done on @p r1 and @p r2, so they
|
* otherwise. No check is done on @p r1 and @p r2, so they must be valid
|
||||||
* must be valid rectangles.
|
* rectangles.
|
||||||
*/
|
*/
|
||||||
static inline Eina_Bool
|
static inline Eina_Bool
|
||||||
eina_rectangles_intersect(const Eina_Rectangle *r1, const Eina_Rectangle *r2)
|
eina_rectangles_intersect(const Eina_Rectangle *r1, const Eina_Rectangle *r2)
|
||||||
|
|
|
@ -612,9 +612,9 @@ EAPI unsigned int eina_inlist_count(const Eina_Inlist *list) EINA_WARN_UNUSED_
|
||||||
* will always return false on eina_iterator_next(), thus keeping API
|
* will always return false on eina_iterator_next(), thus keeping API
|
||||||
* sane.
|
* sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, @c NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator
|
||||||
* returned.
|
* is returned.
|
||||||
*
|
*
|
||||||
* @warning if the list structure changes then the iterator becomes
|
* @warning if the list structure changes then the iterator becomes
|
||||||
* invalid, and if you add or remove nodes iterator
|
* invalid, and if you add or remove nodes iterator
|
||||||
|
|
|
@ -1292,9 +1292,9 @@ static inline unsigned int eina_list_count(const Eina_List *list) EINA_PURE;
|
||||||
* will always return false on eina_iterator_next(), thus keeping API
|
* will always return false on eina_iterator_next(), thus keeping API
|
||||||
* sane.
|
* sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator
|
||||||
* returned.
|
* is returned.
|
||||||
*
|
*
|
||||||
* @warning @p list must be a pointer to the first element of the list.
|
* @warning @p list must be a pointer to the first element of the list.
|
||||||
*
|
*
|
||||||
|
@ -1319,9 +1319,9 @@ EAPI Eina_Iterator *eina_list_iterator_new(const Eina_List *list) EINA_MA
|
||||||
*
|
*
|
||||||
* Unlike eina_list_iterator_new(), this will walk the list backwards.
|
* Unlike eina_list_iterator_new(), this will walk the list backwards.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator
|
||||||
* returned.
|
* is returned.
|
||||||
*
|
*
|
||||||
* @warning @p list must be a pointer to the first element of the list.
|
* @warning @p list must be a pointer to the first element of the list.
|
||||||
*
|
*
|
||||||
|
|
|
@ -232,8 +232,8 @@ EAPI extern Eina_Error EINA_ERROR_MAGIC_FAILED;
|
||||||
/**
|
/**
|
||||||
* @def EINA_MAGIC_SET(d, m)
|
* @def EINA_MAGIC_SET(d, m)
|
||||||
* Set the magic number of @p d to @p m. @p d must be a valid pointer
|
* Set the magic number of @p d to @p m. @p d must be a valid pointer
|
||||||
* to a structure holding an Eina magic number declaration. Use
|
* to a structure holding an Eina magic number declaration.
|
||||||
* #EINA_MAGIC to add such declaration.
|
* Use #EINA_MAGIC to add such declaration.
|
||||||
*
|
*
|
||||||
* If the magic feature of Eina is disabled, #EINA_MAGIC_CHECK is just
|
* If the magic feature of Eina is disabled, #EINA_MAGIC_CHECK is just
|
||||||
* the value @c 0.
|
* the value @c 0.
|
||||||
|
|
|
@ -285,8 +285,8 @@
|
||||||
* Not as generic as #EINA_MODEL_TYPE_GENERIC, but way more efficient
|
* Not as generic as #EINA_MODEL_TYPE_GENERIC, but way more efficient
|
||||||
* is #EINA_MODEL_TYPE_STRUCT that instead of a hash of properties of
|
* is #EINA_MODEL_TYPE_STRUCT that instead of a hash of properties of
|
||||||
* any type, it uses a struct to map properties. Its properties are
|
* any type, it uses a struct to map properties. Its properties are
|
||||||
* fixed set of names and they have fixed type, as defined by the
|
* fixed set of names and they have fixed type, as defined by
|
||||||
* #Eina_Value_Struct_Desc description used internally.
|
* the #Eina_Value_Struct_Desc description used internally.
|
||||||
*
|
*
|
||||||
* Examples:
|
* Examples:
|
||||||
* @li @ref eina_model_01_c inheritance example, uses #EINA_MODEL_TYPE_GENERIC
|
* @li @ref eina_model_01_c inheritance example, uses #EINA_MODEL_TYPE_GENERIC
|
||||||
|
@ -294,8 +294,8 @@
|
||||||
* example that demonstrates several of the important features of
|
* example that demonstrates several of the important features of
|
||||||
* eina_model, uses #EINA_MODEL_TYPE_GENERIC.
|
* eina_model, uses #EINA_MODEL_TYPE_GENERIC.
|
||||||
* @li @ref eina_model_03_example_page walk-through example on how to
|
* @li @ref eina_model_03_example_page walk-through example on how to
|
||||||
* inherit types, a suggestion of eina_model_load() usage and uses
|
* inherit types, a suggestion of eina_model_load() usage and
|
||||||
* #EINA_MODEL_TYPE_STRUCT.
|
* uses #EINA_MODEL_TYPE_STRUCT.
|
||||||
* @li @ref eina_model_04_c Advanced inheritance, interfaces and interface
|
* @li @ref eina_model_04_c Advanced inheritance, interfaces and interface
|
||||||
* function overloading example.
|
* function overloading example.
|
||||||
*
|
*
|
||||||
|
@ -520,9 +520,9 @@ EAPI void eina_model_xunref(Eina_Model *model,
|
||||||
* @defgroup Eina_Model_Event_Group Data Model Events
|
* @defgroup Eina_Model_Event_Group Data Model Events
|
||||||
* Events and their usage with models.
|
* Events and their usage with models.
|
||||||
*
|
*
|
||||||
* Events are specified by each type and interface level using
|
* Events are specified by each type and interface level
|
||||||
* #Eina_Model_Event_Description. One can know all events supported by
|
* using #Eina_Model_Event_Description. One can know all events supported
|
||||||
* a model with eina_model_event_names_list_get() and then
|
* by a model with eina_model_event_names_list_get() and then
|
||||||
* eina_model_event_description_get() to retrieve details.
|
* eina_model_event_description_get() to retrieve details.
|
||||||
*
|
*
|
||||||
* By default the following events are supported in every object:
|
* By default the following events are supported in every object:
|
||||||
|
@ -747,8 +747,8 @@ EAPI Eina_Bool eina_model_load(Eina_Model *model) EINA_ARG_NONNULL(1);
|
||||||
* by user defined types can be given.
|
* by user defined types can be given.
|
||||||
*
|
*
|
||||||
* @note The types provided by Eina_Model don't implement this method.
|
* @note The types provided by Eina_Model don't implement this method.
|
||||||
* @note Calling this function on a model that doesn't implement it returns @c
|
* @note Calling this function on a model that doesn't implement it
|
||||||
* EINA_TRUE without any effect on @a model.
|
* returns #EINA_TRUE without any effect on @a model.
|
||||||
*
|
*
|
||||||
* @see eina_model_load()
|
* @see eina_model_load()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -774,9 +774,7 @@ EAPI Eina_Bool eina_model_unload(Eina_Model *model) EINA_ARG_NONNULL(1);
|
||||||
* @param[in] model The model from which to get the property.
|
* @param[in] model The model from which to get the property.
|
||||||
* @param[in] name The name of the property whose value is wanted.
|
* @param[in] name The name of the property whose value is wanted.
|
||||||
* @param[out] value A pointer to an Eina_Value to receive the property's value.
|
* @param[out] value A pointer to an Eina_Value to receive the property's value.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE if @a model has a property named @a name, #EINA_FALSE
|
||||||
*
|
|
||||||
* @return EINA_TRUE if @a model has a property named @a name, EINA_FALSE
|
|
||||||
* otherwise.
|
* otherwise.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_set()
|
* @see eina_model_property_set()
|
||||||
|
@ -1357,8 +1355,8 @@ EAPI char *eina_model_to_string(const Eina_Model *model) EINA_ARG_NONNULL(1) EIN
|
||||||
* order. Whenever they do not exist, their parent pointer is
|
* order. Whenever they do not exist, their parent pointer is
|
||||||
* called.
|
* called.
|
||||||
* @note a runtime check will enforce just types with ABI version
|
* @note a runtime check will enforce just types with ABI version
|
||||||
* #EINA_MODEL_TYPE_VERSION are used by comparing with the @c version
|
* version #EINA_MODEL_TYPE_VERSION are used by comparing with
|
||||||
* member.
|
* the @c version member.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
*/
|
*/
|
||||||
|
@ -1563,7 +1561,7 @@ struct _Eina_Model_Type
|
||||||
* done his own(this is as to ensure you can call on your parent's methods).
|
* done his own(this is as to ensure you can call on your parent's methods).
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_new()
|
* @see eina_model_new()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1592,7 +1590,7 @@ EAPI Eina_Bool eina_model_type_constructor(const Eina_Model_Type *type,
|
||||||
* calling the parent's destructor.
|
* calling the parent's destructor.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_del()
|
* @see eina_model_del()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1608,7 +1606,7 @@ EAPI Eina_Bool eina_model_type_destructor(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_copy()
|
* @see eina_model_copy()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1625,7 +1623,7 @@ EAPI Eina_Bool eina_model_type_copy(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_deep_copy()
|
* @see eina_model_deep_copy()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1644,7 +1642,7 @@ EAPI Eina_Bool eina_model_type_deep_copy(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_compare()
|
* @see eina_model_compare()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1661,7 +1659,7 @@ EAPI Eina_Bool eina_model_type_compare(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_load()
|
* @see eina_model_load()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1676,7 +1674,7 @@ EAPI Eina_Bool eina_model_type_load(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_unload()
|
* @see eina_model_unload()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1690,10 +1688,10 @@ EAPI Eina_Bool eina_model_type_unload(const Eina_Model_Type *type,
|
||||||
* @param[in] model The model instance.
|
* @param[in] model The model instance.
|
||||||
* @param[in] name Name of property to get.
|
* @param[in] name Name of property to get.
|
||||||
* @param[out] value Pointer to where value of property will be placed.
|
* @param[out] value Pointer to where value of property will be placed.
|
||||||
* @return EINA_TRUE if able to get property, EINA_FALSE otherwise.
|
* @return #EINA_TRUE if able to get property, #EINA_FALSE otherwise.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_get()
|
* @see eina_model_property_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1712,7 +1710,7 @@ EAPI Eina_Bool eina_model_type_property_get(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_set()
|
* @see eina_model_property_set()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1730,7 +1728,7 @@ EAPI Eina_Bool eina_model_type_property_set(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_del()
|
* @see eina_model_property_del()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1746,7 +1744,7 @@ EAPI Eina_Bool eina_model_type_property_del(const Eina_Model_Type *type,
|
||||||
* @return #Eina_List of properties' names.
|
* @return #Eina_List of properties' names.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_properties_names_list_get()
|
* @see eina_model_properties_names_list_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1761,7 +1759,7 @@ EAPI Eina_List *eina_model_type_properties_names_list_get(const Eina_Model_Type
|
||||||
* @return Number of children in @a model.
|
* @return Number of children in @a model.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_count()
|
* @see eina_model_child_count()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1777,7 +1775,7 @@ EAPI int eina_model_type_child_count(const Eina_Model_Type *type,
|
||||||
* @return The child model, or NULL on failure.
|
* @return The child model, or NULL on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_get()
|
* @see eina_model_child_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1813,7 +1811,7 @@ EAPI Eina_Bool eina_model_type_child_set(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_del()
|
* @see eina_model_child_del()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1831,7 +1829,7 @@ EAPI Eina_Bool eina_model_type_child_del(const Eina_Model_Type *type,
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_insert_at()
|
* @see eina_model_child_insert_at()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1850,7 +1848,7 @@ EAPI Eina_Bool eina_model_type_child_insert_at(const Eina_Model_Type *type,
|
||||||
* @return The index of the searched child, or -1 if not found.
|
* @return The index of the searched child, or -1 if not found.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_find()
|
* @see eina_model_child_find()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1871,7 +1869,7 @@ EAPI int eina_model_type_child_find(const Eina_Model_Type *type,
|
||||||
* child matches it.
|
* child matches it.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_criteria_match()
|
* @see eina_model_child_criteria_match()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1889,7 +1887,7 @@ EAPI int eina_model_type_child_criteria_match(const Eina_Model_Type *type,
|
||||||
* @param compare Function used to compare children.
|
* @param compare Function used to compare children.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_sort()
|
* @see eina_model_child_sort()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1907,7 +1905,7 @@ EAPI void eina_model_type_child_sort(const Eina_Model_Type *type,
|
||||||
* @return Newly created iterator instance on success or @c NULL on failure.
|
* @return Newly created iterator instance on success or @c NULL on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_iterator_get()
|
* @see eina_model_child_iterator_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1926,7 +1924,7 @@ EAPI Eina_Iterator *eina_model_type_child_iterator_get(const Eina_Model_Type *ty
|
||||||
* @return Newly created iterator instance on success or @c NULL on failure.
|
* @return Newly created iterator instance on success or @c NULL on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_reversed_iterator_get()
|
* @see eina_model_child_reversed_iterator_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1946,7 +1944,7 @@ EAPI Eina_Iterator *eina_model_type_child_reversed_iterator_get(const Eina_Model
|
||||||
* @return Newly created iterator instance on success or @c NULL on failure.
|
* @return Newly created iterator instance on success or @c NULL on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_sorted_iterator_get()
|
* @see eina_model_child_sorted_iterator_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1968,7 +1966,7 @@ EAPI Eina_Iterator *eina_model_type_child_sorted_iterator_get(const Eina_Model_T
|
||||||
* @return Newly created iterator instance on success or @c NULL on failure.
|
* @return Newly created iterator instance on success or @c NULL on failure.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_filtered_iterator_get()
|
* @see eina_model_child_filtered_iterator_get()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -1987,7 +1985,7 @@ EAPI Eina_Iterator *eina_model_type_child_filtered_iterator_get(const Eina_Model
|
||||||
* @return String representationof @a model.
|
* @return String representationof @a model.
|
||||||
*
|
*
|
||||||
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
* @warning If model doesn't inherit from (or is of) @a type does nothing and
|
||||||
* returns EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_to_string()
|
* @see eina_model_to_string()
|
||||||
* @see _Eina_Model_Type
|
* @see _Eina_Model_Type
|
||||||
|
@ -2109,9 +2107,9 @@ EAPI const void *eina_model_type_method_offset_resolve(const Eina_Model_Type *ty
|
||||||
* type counterparts. Unlike setup and flush, they are not
|
* type counterparts. Unlike setup and flush, they are not
|
||||||
* guaranteed to be called.
|
* guaranteed to be called.
|
||||||
* @note use the same name pointer on queries to speed up the lookups!
|
* @note use the same name pointer on queries to speed up the lookups!
|
||||||
* @note a runtime check will enforce just types with ABI version
|
* @note a runtime check will enforce just types with ABI
|
||||||
* #EINA_MODEL_INTERFACE_VERSION are used by comparing with the
|
* version #EINA_MODEL_INTERFACE_VERSION are used by comparing
|
||||||
* @c version member.
|
* with the @c version member.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
*/
|
*/
|
||||||
|
@ -2214,8 +2212,8 @@ struct _Eina_Model_Interface
|
||||||
* @param model The model instance.
|
* @param model The model instance.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If @a model doesn't implement @a iface does nothing and returns
|
* @warning If @a model doesn't implement @a iface does nothing and
|
||||||
* EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_new()
|
* @see eina_model_new()
|
||||||
* @see _Eina_Model_Interface
|
* @see _Eina_Model_Interface
|
||||||
|
@ -2229,8 +2227,8 @@ EAPI Eina_Bool eina_model_interface_constructor(const Eina_Model_Interface *ifac
|
||||||
* @param model The model instance.
|
* @param model The model instance.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If @a model doesn't implement @a iface does nothing and returns
|
* @warning If @a model doesn't implement @a iface does nothing and
|
||||||
* EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_del()
|
* @see eina_model_del()
|
||||||
* @see _Eina_Model_Interface
|
* @see _Eina_Model_Interface
|
||||||
|
@ -2245,8 +2243,8 @@ EAPI Eina_Bool eina_model_interface_destructor(const Eina_Model_Interface *iface
|
||||||
* @param dst Pointer to where copy will be put.
|
* @param dst Pointer to where copy will be put.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If @a model doesn't implement @a iface does nothing and returns
|
* @warning If @a model doesn't implement @a iface does nothing and
|
||||||
* EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_copy()
|
* @see eina_model_copy()
|
||||||
* @see _Eina_Model_Interface
|
* @see _Eina_Model_Interface
|
||||||
|
@ -2262,8 +2260,8 @@ EAPI Eina_Bool eina_model_interface_copy(const Eina_Model_Interface *iface,
|
||||||
* @param dst Pointer to where copy will be put.
|
* @param dst Pointer to where copy will be put.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If @a model doesn't implement @a iface does nothing and returns
|
* @warning If @a model doesn't implement @a iface does nothing and
|
||||||
* EINA_FALSE.
|
* returns #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_deep_copy()
|
* @see eina_model_deep_copy()
|
||||||
* @see _Eina_Model_Interface
|
* @see _Eina_Model_Interface
|
||||||
|
@ -2472,8 +2470,8 @@ EAPI void *eina_model_interface_private_data_get(const Eina_Model *model,
|
||||||
* @typedef Eina_Model_Interface_Properties
|
* @typedef Eina_Model_Interface_Properties
|
||||||
* Interface to manage model's properties.
|
* Interface to manage model's properties.
|
||||||
*
|
*
|
||||||
* This extends #Eina_Model_Interface as expected by interface name
|
* This extends #Eina_Model_Interface as expected by interface
|
||||||
* #EINA_MODEL_INTERFACE_NAME_PROPERTIES.
|
* name #EINA_MODEL_INTERFACE_NAME_PROPERTIES.
|
||||||
*
|
*
|
||||||
* This interface is meant to help managing properties of a model, it
|
* This interface is meant to help managing properties of a model, it
|
||||||
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
||||||
|
@ -2488,8 +2486,8 @@ typedef struct _Eina_Model_Interface_Properties Eina_Model_Interface_Properties;
|
||||||
* @struct _Eina_Model_Interface_Properties
|
* @struct _Eina_Model_Interface_Properties
|
||||||
* Interface to manage model's properties.
|
* Interface to manage model's properties.
|
||||||
*
|
*
|
||||||
* This extends #Eina_Model_Interface as expected by interface name
|
* This extends #Eina_Model_Interface as expected by interface
|
||||||
* #EINA_MODEL_INTERFACE_NAME_PROPERTIES.
|
* name #EINA_MODEL_INTERFACE_NAME_PROPERTIES.
|
||||||
*
|
*
|
||||||
* This interface is meant to help managing properties of a model, it
|
* This interface is meant to help managing properties of a model, it
|
||||||
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
||||||
|
@ -2521,7 +2519,7 @@ struct _Eina_Model_Interface_Properties
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_compare()
|
* @see eina_model_compare()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2538,7 +2536,7 @@ EAPI Eina_Bool eina_model_interface_properties_compare(const Eina_Model_Interfac
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_load()
|
* @see eina_model_load()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2552,7 +2550,7 @@ EAPI Eina_Bool eina_model_interface_properties_load(const Eina_Model_Interface *
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_unload()
|
* @see eina_model_unload()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2568,7 +2566,7 @@ EAPI Eina_Bool eina_model_interface_properties_unload(const Eina_Model_Interface
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_get()
|
* @see eina_model_property_get()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2586,7 +2584,7 @@ EAPI Eina_Bool eina_model_interface_properties_get(const Eina_Model_Interface *i
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_set()
|
* @see eina_model_property_set()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2603,7 +2601,7 @@ EAPI Eina_Bool eina_model_interface_properties_set(const Eina_Model_Interface *i
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_property_del()
|
* @see eina_model_property_del()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2620,7 +2618,7 @@ EAPI Eina_Bool eina_model_interface_properties_del(const Eina_Model_Interface *i
|
||||||
* @return #Eina_List of properties' names.
|
* @return #Eina_List of properties' names.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_properties_names_list_get()
|
* @see eina_model_properties_names_list_get()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2632,8 +2630,8 @@ EAPI Eina_List *eina_model_interface_properties_names_list_get(const Eina_Model_
|
||||||
* @typedef Eina_Model_Interface_Children
|
* @typedef Eina_Model_Interface_Children
|
||||||
* Interface to manage model's children.
|
* Interface to manage model's children.
|
||||||
*
|
*
|
||||||
* This extends #Eina_Model_Interface as expected by interface name
|
* This extends #Eina_Model_Interface as expected by interface
|
||||||
* #EINA_MODEL_INTERFACE_NAME_CHILDREN.
|
* name #EINA_MODEL_INTERFACE_NAME_CHILDREN.
|
||||||
*
|
*
|
||||||
* This interface is meant to help managing properties of a model, it
|
* This interface is meant to help managing properties of a model, it
|
||||||
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
||||||
|
@ -2654,8 +2652,8 @@ typedef struct _Eina_Model_Interface_Children Eina_Model_Interface_Children;
|
||||||
* @struct _Eina_Model_Interface_Children
|
* @struct _Eina_Model_Interface_Children
|
||||||
* Interface to manage model's children.
|
* Interface to manage model's children.
|
||||||
*
|
*
|
||||||
* This extends #Eina_Model_Interface as expected by interface name
|
* This extends #Eina_Model_Interface as expected by interface
|
||||||
* #EINA_MODEL_INTERFACE_NAME_CHILDREN.
|
* name #EINA_MODEL_INTERFACE_NAME_CHILDREN.
|
||||||
*
|
*
|
||||||
* This interface is meant to help managing properties of a model, it
|
* This interface is meant to help managing properties of a model, it
|
||||||
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
* is used by #EINA_MODEL_TYPE_MIXIN in order to configure methods for
|
||||||
|
@ -2689,7 +2687,7 @@ struct _Eina_Model_Interface_Children
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_compare()
|
* @see eina_model_compare()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2705,7 +2703,7 @@ EAPI Eina_Bool eina_model_interface_children_compare(const Eina_Model_Interface
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_load()
|
* @see eina_model_load()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2719,7 +2717,7 @@ EAPI Eina_Bool eina_model_interface_children_load(const Eina_Model_Interface *if
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return EINA_FALSE.
|
* return #EINA_FALSE.
|
||||||
*
|
*
|
||||||
* @see eina_model_unload()
|
* @see eina_model_unload()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2733,7 +2731,7 @@ EAPI Eina_Bool eina_model_interface_children_unload(const Eina_Model_Interface *
|
||||||
* @return Number of children in @a model.
|
* @return Number of children in @a model.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return -1.
|
* return @c -1.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_count()
|
* @see eina_model_child_count()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2748,7 +2746,7 @@ EAPI int eina_model_interface_children_count(const Eina_Model_Interface *iface,
|
||||||
* @return The requested child.
|
* @return The requested child.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return -1.
|
* return @c -1.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_get()
|
* @see eina_model_child_get()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2765,7 +2763,7 @@ EAPI Eina_Model *eina_model_interface_children_get(const Eina_Model_Interface *i
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return -1.
|
* return @c -1.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_set()
|
* @see eina_model_child_set()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2782,7 +2780,7 @@ EAPI Eina_Bool eina_model_interface_children_set(const Eina_Model_Interface *ifa
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return -1.
|
* return @c -1.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_del()
|
* @see eina_model_child_del()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2799,7 +2797,7 @@ EAPI Eina_Bool eina_model_interface_children_del(const Eina_Model_Interface *ifa
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* @warning If either model doesn't implement @a iface will do nothing and
|
* @warning If either model doesn't implement @a iface will do nothing and
|
||||||
* return -1.
|
* return @c -1.
|
||||||
*
|
*
|
||||||
* @see eina_model_child_insert_at()
|
* @see eina_model_child_insert_at()
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -2986,8 +2984,8 @@ EAPI extern const Eina_Model_Type *EINA_MODEL_TYPE_BASE;
|
||||||
/**
|
/**
|
||||||
* @var EINA_MODEL_TYPE_MIXIN
|
* @var EINA_MODEL_TYPE_MIXIN
|
||||||
*
|
*
|
||||||
* Type that uses #EINA_MODEL_INTERFACE_NAME_PROPERTIES and
|
* Type that uses #EINA_MODEL_INTERFACE_NAME_PROPERTIES
|
||||||
* #EINA_MODEL_INTERFACE_NAME_CHILDREN to manage the model.
|
* and #EINA_MODEL_INTERFACE_NAME_CHILDREN to manage the model.
|
||||||
*
|
*
|
||||||
* This is an abstract type, it does not work out of the box as one
|
* This is an abstract type, it does not work out of the box as one
|
||||||
* needs to subclass it and define the interface implementations for
|
* needs to subclass it and define the interface implementations for
|
||||||
|
@ -3002,9 +3000,9 @@ EAPI extern const Eina_Model_Type *EINA_MODEL_TYPE_MIXIN;
|
||||||
/**
|
/**
|
||||||
* @var EINA_MODEL_TYPE_GENERIC
|
* @var EINA_MODEL_TYPE_GENERIC
|
||||||
*
|
*
|
||||||
* Subclass of #EINA_MODEL_TYPE_MIXIN that uses
|
* Subclass of #EINA_MODEL_TYPE_MIXIN that
|
||||||
* #EINA_MODEL_INTERFACE_PROPERTIES_HASH and
|
* uses #EINA_MODEL_INTERFACE_PROPERTIES_HASH
|
||||||
* #EINA_MODEL_INTERFACE_CHILDREN_INARRAY.
|
* and #EINA_MODEL_INTERFACE_CHILDREN_INARRAY.
|
||||||
*
|
*
|
||||||
* Should be generic enough to hold lots of items with runtime
|
* Should be generic enough to hold lots of items with runtime
|
||||||
* configurable properties of any type.
|
* configurable properties of any type.
|
||||||
|
@ -3018,9 +3016,9 @@ EAPI extern const Eina_Model_Type *EINA_MODEL_TYPE_GENERIC;
|
||||||
/**
|
/**
|
||||||
* @var EINA_MODEL_TYPE_STRUCT
|
* @var EINA_MODEL_TYPE_STRUCT
|
||||||
*
|
*
|
||||||
* Subclass of #EINA_MODEL_TYPE_MIXIN that uses
|
* Subclass of #EINA_MODEL_TYPE_MIXIN that
|
||||||
* #EINA_MODEL_INTERFACE_PROPERTIES_STRUCT and
|
* uses #EINA_MODEL_INTERFACE_PROPERTIES_STRUCT
|
||||||
* #EINA_MODEL_INTERFACE_CHILDREN_INARRAY.
|
* and #EINA_MODEL_INTERFACE_CHILDREN_INARRAY.
|
||||||
*
|
*
|
||||||
* Should be struct enough to hold lots of items with compile time
|
* Should be struct enough to hold lots of items with compile time
|
||||||
* configurable properties of any type.
|
* configurable properties of any type.
|
||||||
|
@ -3093,8 +3091,8 @@ EAPI Eina_Bool eina_model_struct_get(const Eina_Model *model,
|
||||||
/**
|
/**
|
||||||
* @var EINA_MODEL_INTERFACE_NAME_PROPERTIES
|
* @var EINA_MODEL_INTERFACE_NAME_PROPERTIES
|
||||||
*
|
*
|
||||||
* Interface that uses #Eina_Model_Interface_Properties as
|
* Interface that uses #Eina_Model_Interface_Properties
|
||||||
* #Eina_Model_Interface and can manage the model properties.
|
* as #Eina_Model_Interface and can manage the model properties.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
*/
|
*/
|
||||||
|
@ -3122,8 +3120,8 @@ EAPI extern const Eina_Model_Interface *EINA_MODEL_INTERFACE_PROPERTIES_HASH;
|
||||||
* Implements #Eina_Model_Interface_Properties
|
* Implements #Eina_Model_Interface_Properties
|
||||||
* (#EINA_MODEL_INTERFACE_NAME_PROPERTIES) using #Eina_Value_Struct.
|
* (#EINA_MODEL_INTERFACE_NAME_PROPERTIES) using #Eina_Value_Struct.
|
||||||
*
|
*
|
||||||
* The interface private data is #Eina_Value of type
|
* The interface private data is #Eina_Value of
|
||||||
* #EINA_VALUE_TYPE_STRUCT. Properties will be accessed using
|
* type #EINA_VALUE_TYPE_STRUCT. Properties will be accessed using
|
||||||
* Eina_Value_Struct::desc information that can be set by types such
|
* Eina_Value_Struct::desc information that can be set by types such
|
||||||
* as #EINA_MODEL_TYPE_STRUCT
|
* as #EINA_MODEL_TYPE_STRUCT
|
||||||
*
|
*
|
||||||
|
@ -3136,8 +3134,8 @@ EAPI extern const Eina_Model_Interface *EINA_MODEL_INTERFACE_PROPERTIES_STRUCT;
|
||||||
/**
|
/**
|
||||||
* @var EINA_MODEL_INTERFACE_NAME_CHILDREN
|
* @var EINA_MODEL_INTERFACE_NAME_CHILDREN
|
||||||
*
|
*
|
||||||
* Interface that uses #Eina_Model_Interface_Children as
|
* Interface that uses #Eina_Model_Interface_Children
|
||||||
* #Eina_Model_Interface and can manage the model children.
|
* as #Eina_Model_Interface and can manage the model children.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -101,8 +101,7 @@ typedef void (*Eina_Module_Shutdown)(void);
|
||||||
/**
|
/**
|
||||||
* @def EINA_MODULE_SHUTDOWN
|
* @def EINA_MODULE_SHUTDOWN
|
||||||
* declares the given function as the module shutdownializer
|
* declares the given function as the module shutdownializer
|
||||||
* (__eina_module_shutdown). It must be of signature
|
* (__eina_module_shutdown). It must be of signature #Eina_Module_Shutdown
|
||||||
* #Eina_Module_Shutdown
|
|
||||||
*/
|
*/
|
||||||
#define EINA_MODULE_SHUTDOWN(f) EAPI Eina_Module_Shutdown __eina_module_shutdown = &f
|
#define EINA_MODULE_SHUTDOWN(f) EAPI Eina_Module_Shutdown __eina_module_shutdown = &f
|
||||||
|
|
||||||
|
@ -159,12 +158,11 @@ EAPI Eina_Bool
|
||||||
* eina_module_new(). If it is a internal Eina module (like the
|
* eina_module_new(). If it is a internal Eina module (like the
|
||||||
* mempools), it also initialize it. It the shared file object can not
|
* mempools), it also initialize it. It the shared file object can not
|
||||||
* be loaded, the error #EINA_ERROR_WRONG_MODULE is set and
|
* be loaded, the error #EINA_ERROR_WRONG_MODULE is set and
|
||||||
* #EINA_FALSE is returned. If it is a internal Eina module and the
|
* and #EINA_FALSE is returned. If it is a internal Eina module and the
|
||||||
* module can not be initialized, the error
|
* module can not be initialized, the error #EINA_ERROR_MODULE_INIT_FAILED
|
||||||
* #EINA_ERROR_MODULE_INIT_FAILED is set and #EINA_FALSE is
|
* is set and #EINA_FALSE is returned. If the module has already been loaded,
|
||||||
* returned. If the module has already been loaded, it's reference
|
* it's reference counter is increased by one and #EINA_TRUE is returned.
|
||||||
* counter is increased by one and #EINA_TRUE is returned. If @p module is
|
* If @p module is @c NULL, the function returns immediately #EINA_FALSE.
|
||||||
* @c NULL, the function returns immediately #EINA_FALSE.
|
|
||||||
*
|
*
|
||||||
* When the symbols of the shared file objects are not needed
|
* When the symbols of the shared file objects are not needed
|
||||||
* anymore, call eina_module_unload() to unload the module.
|
* anymore, call eina_module_unload() to unload the module.
|
||||||
|
|
|
@ -202,8 +202,8 @@ static inline Eina_Rbtree *eina_rbtree_inline_lookup(const Eina_Rbtree *root, co
|
||||||
* NULL, this function still returns a valid iterator that will always
|
* NULL, this function still returns a valid iterator that will always
|
||||||
* return false on eina_iterator_next(), thus keeping API sane.
|
* return false on eina_iterator_next(), thus keeping API sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, @c NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the rbtree structure changes then the iterator becomes
|
* @warning if the rbtree structure changes then the iterator becomes
|
||||||
|
@ -223,8 +223,8 @@ EAPI Eina_Iterator *eina_rbtree_iterator_prefix(const Eina_Rbtree *root)
|
||||||
* NULL, this function still returns a valid iterator that will always
|
* NULL, this function still returns a valid iterator that will always
|
||||||
* return false on eina_iterator_next(), thus keeping API sane.
|
* return false on eina_iterator_next(), thus keeping API sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, @c NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the rbtree structure changes then the iterator becomes
|
* @warning if the rbtree structure changes then the iterator becomes
|
||||||
|
@ -244,8 +244,8 @@ EAPI Eina_Iterator *eina_rbtree_iterator_infix(const Eina_Rbtree *root) E
|
||||||
* NULL, this function still returns a valid iterator that will always
|
* NULL, this function still returns a valid iterator that will always
|
||||||
* return false on eina_iterator_next(), thus keeping API sane.
|
* return false on eina_iterator_next(), thus keeping API sane.
|
||||||
*
|
*
|
||||||
* If the memory can not be allocated, NULL is returned and
|
* If the memory can not be allocated, @c NULL is returned
|
||||||
* #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
* and #EINA_ERROR_OUT_OF_MEMORY is set. Otherwise, a valid iterator is
|
||||||
* returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @warning if the rbtree structure changes then the iterator becomes
|
* @warning if the rbtree structure changes then the iterator becomes
|
||||||
|
|
|
@ -146,8 +146,8 @@ EAPI void eina_strbuf_reset(Eina_Strbuf *buf) EINA_ARG_NONNULL(1);
|
||||||
* This function appends @p str to @p buf. It computes the length of
|
* This function appends @p str to @p buf. It computes the length of
|
||||||
* @p str, so is slightly slower than eina_strbuf_append_length(). If
|
* @p str, so is slightly slower than eina_strbuf_append_length(). If
|
||||||
* the length is known beforehand, consider using that variant. If
|
* the length is known beforehand, consider using that variant. If
|
||||||
* @p buf can't append it, #EINA_FALSE is returned, otherwise
|
* @p buf can't append it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @see eina_strbuf_append()
|
* @see eina_strbuf_append()
|
||||||
* @see eina_strbuf_append_length()
|
* @see eina_strbuf_append_length()
|
||||||
|
@ -219,8 +219,8 @@ EAPI Eina_Bool eina_strbuf_append_length(Eina_Strbuf *buf, const char *str, size
|
||||||
* @param c The char to append.
|
* @param c The char to append.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This function inserts @p c to @p buf. If it can not insert it,
|
* This function inserts @p c to @p buf. If it can not insert it, #EINA_FALSE
|
||||||
* #EINA_FALSE is returned, otherwise #EINA_TRUE is returned.
|
* is returned, otherwise #EINA_TRUE is returned.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eina_strbuf_append_char(Eina_Strbuf *buf, char c) EINA_ARG_NONNULL(1);
|
EAPI Eina_Bool eina_strbuf_append_char(Eina_Strbuf *buf, char c) EINA_ARG_NONNULL(1);
|
||||||
|
|
||||||
|
@ -349,8 +349,8 @@ EAPI Eina_Bool eina_strbuf_insert_char(Eina_Strbuf *buf, char c, size_t pos) EIN
|
||||||
*
|
*
|
||||||
* This function insert a string as described by the format @p fmt to @p buf at
|
* This function insert a string as described by the format @p fmt to @p buf at
|
||||||
* the position @p pos. @p fmt must be of a valid format for printf family of
|
* the position @p pos. @p fmt must be of a valid format for printf family of
|
||||||
* functions. If it can't insert it, #EINA_FALSE is returned, otherwise
|
* functions. If it can't insert it, #EINA_FALSE is returned,
|
||||||
* #EINA_TRUE is returned.
|
* otherwise #EINA_TRUE is returned.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eina_strbuf_insert_printf(Eina_Strbuf *buf, const char *fmt, size_t pos, ...) EINA_ARG_NONNULL(1, 2) EINA_PRINTF(2, 4);
|
EAPI Eina_Bool eina_strbuf_insert_printf(Eina_Strbuf *buf, const char *fmt, size_t pos, ...) EINA_ARG_NONNULL(1, 2) EINA_PRINTF(2, 4);
|
||||||
|
|
||||||
|
@ -390,8 +390,8 @@ EAPI Eina_Bool eina_strbuf_insert_vprintf(Eina_Strbuf *buf, const char *fmt, siz
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_strbuf_insert_escaped() at position 0. If
|
* This macro is calling eina_strbuf_insert_escaped() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_strbuf_prepend_escaped(buf, str) eina_strbuf_insert_escaped(buf, str, 0)
|
#define eina_strbuf_prepend_escaped(buf, str) eina_strbuf_insert_escaped(buf, str, 0)
|
||||||
|
|
||||||
|
@ -405,8 +405,8 @@ EAPI Eina_Bool eina_strbuf_insert_vprintf(Eina_Strbuf *buf, const char *fmt, siz
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_strbuf_insert_n() at position 0. If
|
* This macro is calling eina_strbuf_insert_n() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_strbuf_prepend_n(buf, str, maxlen) eina_strbuf_insert_n(buf, str, maxlen, 0)
|
#define eina_strbuf_prepend_n(buf, str, maxlen) eina_strbuf_insert_n(buf, str, maxlen, 0)
|
||||||
|
|
||||||
|
@ -420,8 +420,8 @@ EAPI Eina_Bool eina_strbuf_insert_vprintf(Eina_Strbuf *buf, const char *fmt, siz
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_strbuf_insert_length() at position 0. If
|
* This macro is calling eina_strbuf_insert_length() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_strbuf_prepend_length(buf, str, length) eina_strbuf_insert_length(buf, str, length, 0)
|
#define eina_strbuf_prepend_length(buf, str, length) eina_strbuf_insert_length(buf, str, length, 0)
|
||||||
|
|
||||||
|
@ -434,8 +434,8 @@ EAPI Eina_Bool eina_strbuf_insert_vprintf(Eina_Strbuf *buf, const char *fmt, siz
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_strbuf_insert_char() at position 0. If
|
* This macro is calling eina_strbuf_insert_char() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE
|
||||||
* #EINA_TRUE is returned.
|
* is returned.
|
||||||
*/
|
*/
|
||||||
#define eina_strbuf_prepend_char(buf, c) eina_strbuf_insert_char(buf, c, 0)
|
#define eina_strbuf_prepend_char(buf, c) eina_strbuf_insert_char(buf, c, 0)
|
||||||
|
|
||||||
|
|
|
@ -254,8 +254,7 @@ EAPI Eina_Iterator *eina_tiler_iterator_new(const Eina_Tiler *t);
|
||||||
*
|
*
|
||||||
* The region defined by @a x, @a y, @a w, @a h will be divided in to a grid of
|
* The region defined by @a x, @a y, @a w, @a h will be divided in to a grid of
|
||||||
* tiles of width @a tile_w and height @p tile_h, the returned iterator will
|
* tiles of width @a tile_w and height @p tile_h, the returned iterator will
|
||||||
* iterate over every tile in the grid having as its data a
|
* iterate over every tile in the grid having as its data a #Eina_Tile_Grid_Info.
|
||||||
* #Eina_Tile_Grid_Info.
|
|
||||||
*
|
*
|
||||||
* @note This is a convenience function, iterating over the returned iterator is
|
* @note This is a convenience function, iterating over the returned iterator is
|
||||||
* equivalent to calling eina_tile_grid_slicer_setup() and calling
|
* equivalent to calling eina_tile_grid_slicer_setup() and calling
|
||||||
|
|
|
@ -115,8 +115,8 @@ EAPI void eina_ustrbuf_reset(Eina_UStrbuf *buf) EINA_ARG_NONNULL(1);
|
||||||
* This function appends @p str to @p buf. It computes the length of
|
* This function appends @p str to @p buf. It computes the length of
|
||||||
* @p str, so is slightly slower than eina_ustrbuf_append_length(). If
|
* @p str, so is slightly slower than eina_ustrbuf_append_length(). If
|
||||||
* the length is known beforehand, consider using that variant. If
|
* the length is known beforehand, consider using that variant. If
|
||||||
* @p buf can't append it, #EINA_FALSE is returned, otherwise
|
* @p buf can't append it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @see eina_ustrbuf_append()
|
* @see eina_ustrbuf_append()
|
||||||
* @see eina_ustrbuf_append_length()
|
* @see eina_ustrbuf_append_length()
|
||||||
|
@ -131,8 +131,8 @@ EAPI Eina_Bool eina_ustrbuf_append(Eina_UStrbuf *buf, const Eina_Unicode *str) E
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This function appends the escaped string @p str to @p buf. If @p
|
* This function appends the escaped string @p str to @p buf. If @p
|
||||||
* str can not be appended, #EINA_FALSE is returned, otherwise,
|
* str can not be appended, #EINA_FALSE is returned, otherwise, #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eina_ustrbuf_append_escaped(Eina_UStrbuf *buf, const Eina_Unicode *str) EINA_ARG_NONNULL(1, 2);
|
EAPI Eina_Bool eina_ustrbuf_append_escaped(Eina_UStrbuf *buf, const Eina_Unicode *str) EINA_ARG_NONNULL(1, 2);
|
||||||
|
|
||||||
|
@ -188,8 +188,8 @@ EAPI Eina_Bool eina_ustrbuf_append_length(Eina_UStrbuf *buf, const Eina_Unicode
|
||||||
* @param c The char to append.
|
* @param c The char to append.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This function inserts @p c to @p buf. If it can not insert it,
|
* This function inserts @p c to @p buf. If it can not insert it, #EINA_FALSE
|
||||||
* #EINA_FALSE is returned, otherwise #EINA_TRUE is returned.
|
* is returned, otherwise #EINA_TRUE is returned.
|
||||||
*/
|
*/
|
||||||
EAPI Eina_Bool eina_ustrbuf_append_char(Eina_UStrbuf *buf, Eina_Unicode c) EINA_ARG_NONNULL(1);
|
EAPI Eina_Bool eina_ustrbuf_append_char(Eina_UStrbuf *buf, Eina_Unicode c) EINA_ARG_NONNULL(1);
|
||||||
|
|
||||||
|
@ -304,8 +304,8 @@ EAPI Eina_Bool eina_ustrbuf_insert_char(Eina_UStrbuf *buf, Eina_Unicode c, size_
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_ustrbuf_insert_escaped() at position 0. If
|
* This macro is calling eina_ustrbuf_insert_escaped() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_ustrbuf_prepend_escaped(buf, str) eina_ustrbuf_insert_escaped(buf, str, 0)
|
#define eina_ustrbuf_prepend_escaped(buf, str) eina_ustrbuf_insert_escaped(buf, str, 0)
|
||||||
|
|
||||||
|
@ -319,8 +319,8 @@ EAPI Eina_Bool eina_ustrbuf_insert_char(Eina_UStrbuf *buf, Eina_Unicode c, size_
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_ustrbuf_insert_n() at position 0. If
|
* This macro is calling eina_ustrbuf_insert_n() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_ustrbuf_prepend_n(buf, str, maxlen) eina_ustrbuf_insert_n(buf, str, maxlen, 0)
|
#define eina_ustrbuf_prepend_n(buf, str, maxlen) eina_ustrbuf_insert_n(buf, str, maxlen, 0)
|
||||||
|
|
||||||
|
@ -334,8 +334,8 @@ EAPI Eina_Bool eina_ustrbuf_insert_char(Eina_UStrbuf *buf, Eina_Unicode c, size_
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_ustrbuf_insert_length() at position 0. If
|
* This macro is calling eina_ustrbuf_insert_length() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_ustrbuf_prepend_length(buf, str, length) eina_ustrbuf_insert_length(buf, str, length, 0)
|
#define eina_ustrbuf_prepend_length(buf, str, length) eina_ustrbuf_insert_length(buf, str, length, 0)
|
||||||
|
|
||||||
|
@ -348,8 +348,8 @@ EAPI Eina_Bool eina_ustrbuf_insert_char(Eina_UStrbuf *buf, Eina_Unicode c, size_
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This macro is calling eina_ustrbuf_insert_Eina_Unicode *() at position 0. If
|
* This macro is calling eina_ustrbuf_insert_Eina_Unicode *() at position 0. If
|
||||||
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise
|
* @p buf can't prepend it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*/
|
*/
|
||||||
#define eina_ustrbuf_prepend_char(buf, c) eina_ustrbuf_insert_char(buf, c, 0)
|
#define eina_ustrbuf_prepend_char(buf, c) eina_ustrbuf_insert_char(buf, c, 0)
|
||||||
|
|
||||||
|
|
|
@ -476,8 +476,8 @@ EAPI extern const Eina_Value_Type *EINA_VALUE_TYPE_STRING;
|
||||||
* pointer to an #Eina_Value_Array. For your convenience, use
|
* pointer to an #Eina_Value_Array. For your convenience, use
|
||||||
* eina_value_array_setup().
|
* eina_value_array_setup().
|
||||||
*
|
*
|
||||||
* eina_value_get() and eina_value_pget() takes a pointer to
|
* eina_value_get() and eina_value_pget() takes a pointer
|
||||||
* #Eina_Value_Array, it's an exact copy of the current structure in
|
* to #Eina_Value_Array, it's an exact copy of the current structure in
|
||||||
* use by value, no copies are done.
|
* use by value, no copies are done.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -495,13 +495,12 @@ EAPI extern const Eina_Value_Type *EINA_VALUE_TYPE_ARRAY;
|
||||||
* eina_value_set() takes an #Eina_Value_List where just @c subtype is
|
* eina_value_set() takes an #Eina_Value_List where just @c subtype is
|
||||||
* used. If there is an @c list, it will be copied (including each
|
* used. If there is an @c list, it will be copied (including each
|
||||||
* item) and its contents must be properly configurable as @c
|
* item) and its contents must be properly configurable as @c
|
||||||
* subtype expects. eina_value_pset() takes a pointer to an
|
* subtype expects. eina_value_pset() takes a pointer to an #Eina_Value_List.
|
||||||
* #Eina_Value_List. For your convenience, use
|
* For your convenience, use eina_value_list_setup().
|
||||||
* eina_value_list_setup().
|
|
||||||
*
|
*
|
||||||
* eina_value_get() and eina_value_pget() takes a pointer to
|
* eina_value_get() and eina_value_pget() takes a pointer to #Eina_Value_List,
|
||||||
* #Eina_Value_List, it's an exact copy of the current structure in
|
* it's an exact copy of the current structure in use by value, no copies are
|
||||||
* use by value, no copies are done.
|
* done.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
*/
|
*/
|
||||||
|
@ -522,9 +521,9 @@ EAPI extern const Eina_Value_Type *EINA_VALUE_TYPE_LIST;
|
||||||
* takes a pointer to an #Eina_Value_Hash. For your convenience, use
|
* takes a pointer to an #Eina_Value_Hash. For your convenience, use
|
||||||
* eina_value_hash_setup().
|
* eina_value_hash_setup().
|
||||||
*
|
*
|
||||||
* eina_value_get() and eina_value_pget() takes a pointer to
|
* eina_value_get() and eina_value_pget() takes a pointer to #Eina_Value_Hash,
|
||||||
* #Eina_Value_Hash, it's an exact copy of the current structure in
|
* it's an exact copy of the current structure in use by value, no copies are
|
||||||
* use by value, no copies are done.
|
* done.
|
||||||
*
|
*
|
||||||
* @note be aware that hash data is always an allocated memory of size
|
* @note be aware that hash data is always an allocated memory of size
|
||||||
* defined by @c subtype->value_size. If your @c subtype is an
|
* defined by @c subtype->value_size. If your @c subtype is an
|
||||||
|
@ -557,9 +556,8 @@ EAPI extern const Eina_Value_Type *EINA_VALUE_TYPE_TIMEVAL;
|
||||||
* eina_value_set() takes an #Eina_Value_Blob
|
* eina_value_set() takes an #Eina_Value_Blob
|
||||||
* eina_value_pset() takes a pointer to #Eina_Value_Blob.
|
* eina_value_pset() takes a pointer to #Eina_Value_Blob.
|
||||||
*
|
*
|
||||||
* eina_value_get() and eina_value_pget() takes a pointer to
|
* eina_value_get() and eina_value_pget() takes a pointer to #Eina_Value_Blob
|
||||||
* #Eina_Value_Blob and it's an exact copy of value, no allocations
|
* and it's an exact copy of value, no allocations are made.
|
||||||
* are made.
|
|
||||||
*
|
*
|
||||||
* Memory is untouched unless you provide @c ops (operations) pointer.
|
* Memory is untouched unless you provide @c ops (operations) pointer.
|
||||||
*
|
*
|
||||||
|
@ -578,12 +576,11 @@ EAPI extern const Eina_Value_Type *EINA_VALUE_TYPE_BLOB;
|
||||||
* eina_value_set() takes an #Eina_Value_Struct where just @c desc is
|
* eina_value_set() takes an #Eina_Value_Struct where just @c desc is
|
||||||
* used. If there is an @c memory, it will be copied (including each
|
* used. If there is an @c memory, it will be copied (including each
|
||||||
* member) and its contents must be properly configurable as @c desc
|
* member) and its contents must be properly configurable as @c desc
|
||||||
* expects. eina_value_pset() takes a pointer to an
|
* expects. eina_value_pset() takes a pointer to an #Eina_Value_Struct. For
|
||||||
* #Eina_Value_Struct. For your convenience, use
|
* your convenience, use eina_value_struct_setup().
|
||||||
* eina_value_struct_setup().
|
|
||||||
*
|
*
|
||||||
* eina_value_get() and eina_value_pget() takes a pointer to
|
* eina_value_get() and eina_value_pget() takes a pointer
|
||||||
* #Eina_Value_Struct, it's an exact copy of the current structure in
|
* to #Eina_Value_Struct, it's an exact copy of the current structure in
|
||||||
* use by value, no copies are done.
|
* use by value, no copies are done.
|
||||||
*
|
*
|
||||||
* @since 1.2
|
* @since 1.2
|
||||||
|
@ -628,8 +625,8 @@ struct _Eina_Value
|
||||||
* eg. #EINA_VALUE_TYPE_ARRAY uses eina_value_array_set(),
|
* eg. #EINA_VALUE_TYPE_ARRAY uses eina_value_array_set(),
|
||||||
* eina_value_array_get() and so on.
|
* eina_value_array_get() and so on.
|
||||||
*
|
*
|
||||||
* On failure, @c NULL is returned and either #EINA_ERROR_OUT_OF_MEMORY or
|
* On failure, @c NULL is returned and either #EINA_ERROR_OUT_OF_MEMORY
|
||||||
* #EINA_ERROR_VALUE_FAILED is set.
|
* or #EINA_ERROR_VALUE_FAILED is set.
|
||||||
*
|
*
|
||||||
* @note this calls creates from mempool and then uses
|
* @note this calls creates from mempool and then uses
|
||||||
* eina_value_setup(). Consider using eina_value_flush() and
|
* eina_value_setup(). Consider using eina_value_flush() and
|
||||||
|
@ -661,9 +658,8 @@ EAPI void eina_value_free(Eina_Value *value) EINA_ARG_NONNULL(1);
|
||||||
* Initializes existing generic value storage. The members are managed using the
|
* Initializes existing generic value storage. The members are managed using the
|
||||||
* description specified by @a type.
|
* description specified by @a type.
|
||||||
*
|
*
|
||||||
* Some types may specify more operations, as an example
|
* Some types may specify more operations, as an example #EINA_VALUE_TYPE_ARRAY
|
||||||
* #EINA_VALUE_TYPE_ARRAY uses eina_value_array_set(),
|
* uses eina_value_array_set(), eina_value_array_get() and so on.
|
||||||
* eina_value_array_get() and so on.
|
|
||||||
*
|
*
|
||||||
* @note Existing contents are ignored! If the value was previously used, then
|
* @note Existing contents are ignored! If the value was previously used, then
|
||||||
* use eina_value_flush() first.
|
* use eina_value_flush() first.
|
||||||
|
@ -1107,8 +1103,8 @@ struct _Eina_Value_Array
|
||||||
* Create a new generic value storage of type array. The members are
|
* Create a new generic value storage of type array. The members are
|
||||||
* managed using the description specified by @a subtype.
|
* managed using the description specified by @a subtype.
|
||||||
*
|
*
|
||||||
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY or
|
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY
|
||||||
* #EINA_ERROR_VALUE_FAILED is set.
|
* or #EINA_ERROR_VALUE_FAILED is set.
|
||||||
*
|
*
|
||||||
* @note this creates from mempool and then uses
|
* @note this creates from mempool and then uses
|
||||||
* eina_value_array_setup(). @see eina_value_free() @see
|
* eina_value_array_setup(). @see eina_value_free() @see
|
||||||
|
@ -1129,9 +1125,9 @@ EAPI Eina_Value *eina_value_array_new(const Eina_Value_Type *subtype,
|
||||||
* Initializes new generic value storage of type array with the given
|
* Initializes new generic value storage of type array with the given
|
||||||
* @a subtype.
|
* @a subtype.
|
||||||
*
|
*
|
||||||
* This is the same as calling eina_value_set() with
|
* This is the same as calling eina_value_set()
|
||||||
* #EINA_VALUE_TYPE_ARRAY followed by eina_value_pset() with the
|
* with #EINA_VALUE_TYPE_ARRAY followed by eina_value_pset() with
|
||||||
* #Eina_Value_Array description configured.
|
* the #Eina_Value_Array description configured.
|
||||||
*
|
*
|
||||||
* @note Existing contents are ignored! If the value was previously used, then
|
* @note Existing contents are ignored! If the value was previously used, then
|
||||||
* use eina_value_flush() first.
|
* use eina_value_flush() first.
|
||||||
|
@ -1757,8 +1753,8 @@ struct _Eina_Value_List
|
||||||
* Create a new generic value storage of type list. The members are
|
* Create a new generic value storage of type list. The members are
|
||||||
* managed using the description specified by @a subtype.
|
* managed using the description specified by @a subtype.
|
||||||
*
|
*
|
||||||
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY or
|
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY
|
||||||
* #EINA_ERROR_VALUE_FAILED is set.
|
* or #EINA_ERROR_VALUE_FAILED is set.
|
||||||
*
|
*
|
||||||
* @note this creates from mempool and then uses
|
* @note this creates from mempool and then uses
|
||||||
* eina_value_list_setup().
|
* eina_value_list_setup().
|
||||||
|
@ -1779,9 +1775,9 @@ EAPI Eina_Value *eina_value_list_new(const Eina_Value_Type *subtype) EINA_ARG_NO
|
||||||
* Initializes new generic value storage of type list with the given
|
* Initializes new generic value storage of type list with the given
|
||||||
* @a subtype.
|
* @a subtype.
|
||||||
*
|
*
|
||||||
* This is the same as calling eina_value_set() with
|
* This is the same as calling eina_value_set()
|
||||||
* #EINA_VALUE_TYPE_LIST followed by eina_value_pset() with the
|
* with #EINA_VALUE_TYPE_LIST followed by eina_value_pset() with
|
||||||
* #Eina_Value_List description configured.
|
* the #Eina_Value_List description configured.
|
||||||
*
|
*
|
||||||
* @note Existing contents are ignored! If the value was previously used, then
|
* @note Existing contents are ignored! If the value was previously used, then
|
||||||
* use eina_value_flush() first.
|
* use eina_value_flush() first.
|
||||||
|
@ -2383,8 +2379,8 @@ struct _Eina_Value_Hash
|
||||||
* Create a new generic value storage of type hash. The members are
|
* Create a new generic value storage of type hash. The members are
|
||||||
* managed using the description specified by @a subtype.
|
* managed using the description specified by @a subtype.
|
||||||
*
|
*
|
||||||
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY or
|
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY
|
||||||
* #EINA_ERROR_VALUE_FAILED is set.
|
* or #EINA_ERROR_VALUE_FAILED is set.
|
||||||
*
|
*
|
||||||
* @note this creates from mempool and then uses
|
* @note this creates from mempool and then uses
|
||||||
* eina_value_hash_setup().
|
* eina_value_hash_setup().
|
||||||
|
@ -2407,9 +2403,9 @@ EAPI Eina_Value *eina_value_hash_new(const Eina_Value_Type *subtype, unsigned in
|
||||||
* Initializes new generic value storage of type hash with the given
|
* Initializes new generic value storage of type hash with the given
|
||||||
* @a subtype.
|
* @a subtype.
|
||||||
*
|
*
|
||||||
* This is the same as calling eina_value_set() with
|
* This is the same as calling eina_value_set()
|
||||||
* #EINA_VALUE_TYPE_HASH followed by eina_value_pset() with the
|
* with #EINA_VALUE_TYPE_HASH followed by eina_value_pset() with
|
||||||
* #Eina_Value_Hash description configured.
|
* the #Eina_Value_Hash description configured.
|
||||||
*
|
*
|
||||||
* @note Existing contents are ignored! If the value was previously used, then
|
* @note Existing contents are ignored! If the value was previously used, then
|
||||||
* use eina_value_flush() first.
|
* use eina_value_flush() first.
|
||||||
|
@ -2864,9 +2860,8 @@ EAPI extern const Eina_Value_Struct_Operations *EINA_VALUE_STRUCT_OPERATIONS_STR
|
||||||
* specified as _Eina_Value_Struct_Operations::find_member(). For
|
* specified as _Eina_Value_Struct_Operations::find_member(). For
|
||||||
* structures with huge number of members, consider using a better
|
* structures with huge number of members, consider using a better
|
||||||
* find_member function to quickly finding it! There are two helper
|
* find_member function to quickly finding it! There are two helper
|
||||||
* operations provided to help this:
|
* operations provided to help this: #EINA_VALUE_STRUCT_OPERATIONS_BINSEARCH
|
||||||
* #EINA_VALUE_STRUCT_OPERATIONS_BINSEARCH and
|
* and #EINA_VALUE_STRUCT_OPERATIONS_STRINGSHARE, both depend on properly
|
||||||
* #EINA_VALUE_STRUCT_OPERATIONS_STRINGSHARE, both depend on properly
|
|
||||||
* set #_Eina_Value_Struct_Desc and #_Eina_Value_Struct_Member.
|
* set #_Eina_Value_Struct_Desc and #_Eina_Value_Struct_Member.
|
||||||
*
|
*
|
||||||
* @see #EINA_VALUE_STRUCT_MEMBER
|
* @see #EINA_VALUE_STRUCT_MEMBER
|
||||||
|
@ -2947,8 +2942,8 @@ struct _Eina_Value_Struct
|
||||||
* Create a new generic value storage of type struct. The members are
|
* Create a new generic value storage of type struct. The members are
|
||||||
* managed using the description specified by @a desc.
|
* managed using the description specified by @a desc.
|
||||||
*
|
*
|
||||||
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY or
|
* On failure, @c NULL is returned and #EINA_ERROR_OUT_OF_MEMORY
|
||||||
* #EINA_ERROR_VALUE_FAILED is set.
|
* or #EINA_ERROR_VALUE_FAILED is set.
|
||||||
*
|
*
|
||||||
* @note this creates from mempool and then uses
|
* @note this creates from mempool and then uses
|
||||||
* eina_value_struct_setup().
|
* eina_value_struct_setup().
|
||||||
|
@ -2969,9 +2964,9 @@ EAPI Eina_Value *eina_value_struct_new(const Eina_Value_Struct_Desc *desc) EINA_
|
||||||
* Initializes new generic value storage of type struct with the given
|
* Initializes new generic value storage of type struct with the given
|
||||||
* @a desc.
|
* @a desc.
|
||||||
*
|
*
|
||||||
* This is the same as calling eina_value_set() with
|
* This is the same as calling eina_value_set()
|
||||||
* #EINA_VALUE_TYPE_STRUCT followed by eina_value_pset() with the
|
* with #EINA_VALUE_TYPE_STRUCT followed by eina_value_pset() with
|
||||||
* #Eina_Value_Struct description configured.
|
* the #Eina_Value_Struct description configured.
|
||||||
*
|
*
|
||||||
* @note Existing contents are ignored! If the value was previously used, then
|
* @note Existing contents are ignored! If the value was previously used, then
|
||||||
* use eina_value_flush() first.
|
* use eina_value_flush() first.
|
||||||
|
|
|
@ -113,9 +113,8 @@ static const char EINA_ERROR_CONVERT_OUTRUN_STRING_LENGTH_STR[] =
|
||||||
* eina_init().
|
* eina_init().
|
||||||
*
|
*
|
||||||
* This function sets up the error module of Eina and registers the
|
* This function sets up the error module of Eina and registers the
|
||||||
* errors #EINA_ERROR_CONVERT_0X_NOT_FOUND,
|
* errors #EINA_ERROR_CONVERT_0X_NOT_FOUND, #EINA_ERROR_CONVERT_P_NOT_FOUND
|
||||||
* #EINA_ERROR_CONVERT_P_NOT_FOUND and
|
* and #EINA_ERROR_CONVERT_OUTRUN_STRING_LENGTH.
|
||||||
* #EINA_ERROR_CONVERT_OUTRUN_STRING_LENGTH.
|
|
||||||
*
|
*
|
||||||
* @see eina_init()
|
* @see eina_init()
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -229,8 +229,7 @@ EAPI Eina_Error EINA_ERROR_MODULE_INIT_FAILED = 0;
|
||||||
* called by eina_init().
|
* called by eina_init().
|
||||||
*
|
*
|
||||||
* This function sets up the module module of Eina. It also registers
|
* This function sets up the module module of Eina. It also registers
|
||||||
* the errors #EINA_ERROR_WRONG_MODULE and
|
* the errors #EINA_ERROR_WRONG_MODULE and #EINA_ERROR_MODULE_INIT_FAILED.
|
||||||
* #EINA_ERROR_MODULE_INIT_FAILED.
|
|
||||||
*
|
*
|
||||||
* @see eina_init()
|
* @see eina_init()
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -352,8 +352,8 @@ eina_strbuf_common_reset(size_t csize, Eina_Strbuf *buf)
|
||||||
* This function appends @p str to @p buf. It computes the length of
|
* This function appends @p str to @p buf. It computes the length of
|
||||||
* @p str, so is slightly slower than eina_strbuf_common_append_length(). If
|
* @p str, so is slightly slower than eina_strbuf_common_append_length(). If
|
||||||
* the length is known beforehand, consider using that variant. If
|
* the length is known beforehand, consider using that variant. If
|
||||||
* @p buf can't append it, #EINA_FALSE is returned, otherwise
|
* @p buf can't append it, #EINA_FALSE is returned, otherwise #EINA_TRUE is
|
||||||
* #EINA_TRUE is returned.
|
* returned.
|
||||||
*
|
*
|
||||||
* @see eina_strbuf_common_append()
|
* @see eina_strbuf_common_append()
|
||||||
* @see eina_strbuf_common_append_length()
|
* @see eina_strbuf_common_append_length()
|
||||||
|
@ -565,8 +565,8 @@ eina_strbuf_common_insert_length(size_t csize,
|
||||||
* @param c The char to append.
|
* @param c The char to append.
|
||||||
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
* @return #EINA_TRUE on success, #EINA_FALSE on failure.
|
||||||
*
|
*
|
||||||
* This function inserts @p c to @p buf. If it can not insert it,
|
* This function inserts @p c to @p buf. If it can not insert it, #EINA_FALSE
|
||||||
* #EINA_FALSE is returned, otherwise #EINA_TRUE is returned.
|
* is returned, otherwise #EINA_TRUE is returned.
|
||||||
*/
|
*/
|
||||||
Eina_Bool
|
Eina_Bool
|
||||||
eina_strbuf_common_append_char(size_t csize, Eina_Strbuf *buf, const void *c)
|
eina_strbuf_common_append_char(size_t csize, Eina_Strbuf *buf, const void *c)
|
||||||
|
|
Loading…
Reference in New Issue