WWW-www.enlightenment.org pushed a commit to branch master. http://git.enlightenment.org/website/www-content.git/commit/?id=2d9a69db3e3b1f4c02d3de8a3a45bb618cdfc0bc
commit 2d9a69db3e3b1f4c02d3de8a3a45bb618cdfc0bc Author: Paul <[email protected]> Date: Tue Nov 7 02:17:48 2017 -0800 Wiki page iterator-functions.md changed with summary [created] by Paul --- .../iterator-functions.md.txt | 24 ++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/pages/eina-programming-guide/iterator-functions.md.txt b/pages/eina-programming-guide/iterator-functions.md.txt new file mode 100644 index 00000000..c589731c --- /dev/null +++ b/pages/eina-programming-guide/iterator-functions.md.txt @@ -0,0 +1,24 @@ +--- +~~Title: Iterator Functions~~ +~~NOCACHE~~ +--- + +# Iterator Functions # + +## Related Info ## + +* (Iterator Functions API)[https://build.enlightenment.org/job/nightly_efl_gcc_x86_64/lastSuccessfulBuild/artifact/doc/html/group__Eina__Iterator__Group.html] + +* (Eina Iterator Example)[https://build.enlightenment.org/job/nightly_efl_gcc_x86_64/lastSuccessfulBuild/artifact/doc/html/eina_iterator_01_8c-example.html] + +Eina provides a set of iterator functions to manipulate data types, such as arrays. + +These functions allow access to container elements in a generic way, without knowing which container is used (similar to iterators in the C++ STL). Iterators only allow sequential access (that is, from one element to the next one). For random access, Eina provides accessor functions. + +Getting an iterator to access elements of a given container is done through the functions of that particular container. There is no function to create a generic iterator as iterators absolutely depend on the container. Note that all iterators, regardless of the container type, are always deleted with the same ``eina_iterator_free()`` function. + +To get the data and iterate, use the ``eina_iterator_next()`` function. To call a function on every single element of a container, use the ``eina_iterator_foreach()`` function. + +In addition to iterator functions, each data type also owns a set of macros that provide the iterators, such as ``FOREACH`` or ``REVERSE_FOREACH``. + +[Back to EINA Programming Guide](https://www.enlightenment.org/eina-programming-guide.md) \ No newline at end of file --
