better-enums/doc/tutorial/3-iterate.md

Iteration

Better Enums makes it easy to iterate over the values you have declared. For example, this:

#include <iostream>
#include <enum.h>

<em>ENUM(Channel, int, Red, Green = 2, Blue)</em>

int main()
{

    <em>for</em> (<em>size_t index = 0</em>; <em>index < Channel::_size()</em>; <em>++index</em>) {
        Channel     channel = <em>Channel::_values()[index]</em>;
        std::cout << channel._to_integral() << " ";
    }
    std::cout << std::endl;

will print "0 2 3". And this:

    <em>for</em> (<em>size_t index = 0</em>; <em>index < Channel::_size()</em>; <em>++index</em>) {
        const char  *name = <em>Channel::_names()[index]</em>;
        std::cout << name << " ";
    }
    std::cout << std::endl;

will print "Red Green Blue".

---

If you are using $cxx11, you can have much nicer syntax:

    <em>for (Channel channel : Channel::_values())</em>
        std::cout << <em>channel._to_integral()</em> << " ";
    std::cout << std::endl;

    <em>for (const char *name : Channel::_names())</em>
        std::cout << <em>name</em> << " ";
    std::cout << std::endl;

---

    return 0;
}

%% description = Using Better Enums to iterate over all the constants of an enum, as well as over its names. Also shows the same with C++11 for-each syntax.