NorwayFun
/
efl
forked from enlightenment/efl
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Eina inlist: Improved docs a bit. 

SVN revision: 57825
This commit is contained in:
Tom Hacohen 2011-03-17 15:31:09 +00:00
parent 8dee8ac0ac
commit ca03e3b71c
1 changed files with 12 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
legacy/eina/src/lib/eina_inlist.c
View File

@ -169,6 +169,13 @@ eina_inlist_accessor_free(Eina_Accessor_Inlist *it) {
* Inline lists have their purposes, but if you don't know what those purposes are, go with * Inline lists have their purposes, but if you don't know what those purposes are, go with
* regular lists instead. * regular lists instead.
* *
* Tip: When using inlists in more than one place (that is, passing them around
* functions or keeping a pointer to them in a structure) it's more correct
* to keep a pointer to the first container, and not a pointer to the first
* inlist item (mostly they are the same, but that's not always correct).
* This lets the compiler to do type checking and let the programmer know
* exactly what type this list is.
*
* @code * @code
* #include <Eina.h> * #include <Eina.h>
* #include <stdio.h> * #include <stdio.h>
@ -208,15 +215,15 @@ eina_inlist_accessor_free(Eina_Accessor_Inlist *it) {
* printf("list=%p\n", list); * printf("list=%p\n", list);
* for (itr = list; itr != NULL; itr = itr->next) * for (itr = list; itr != NULL; itr = itr->next)
* { * {
* cur = EINA_INLIST_CONTAINER_GET(itr, struct my_struct); * cur = EINA_INLIST_CONTAINER_GET(itr, struct my_struct);
* printf("\ta=%d, b=%d\n", cur->a, cur->b); * printf("\ta=%d, b=%d\n", cur->a, cur->b);
* } * }
* *
* while (list) * while (list)
* { * {
* Eina_Inlist *aux = list; * Eina_Inlist *aux = list;
* list = eina_inlist_remove(list, list); * list = eina_inlist_remove(list, list);
* free(aux); * free(aux);
* } * }
* *
* eina_shutdown(); * eina_shutdown();