Module enumap

Examples

Suppose you are building a good ol' dungeon-crawling RPG. Where to start? How about the classic 6 attributes:

enum Attribute {
 strength, dexterity, constitution, wisdom, intellect, charisma
};

struct Character {
 Enumap!(Attribute, int) attributes;
}

Lets roll some stats!

Character hero;
hero.attributes = sequence!((a,n) => uniform!"[]"(0, 20))().take(6);

Note that we can assign directly from a range! Just like static array assignment, it will fail if the length doesn't match.

We can access those values using either opIndex or opDispatch:

if (hero.attributes[Attribute.wisdom] < 5) hero.drink(unidentifiedPotion);
// equivalent
if (hero.attributes.wisdom < 5) hero.drink(unidentifiedPotion);

We can also perform binary operations between Enumaps:

// note the convenient assignment from an associative array:
Enumap!(Attribute, int) bonus = {Attribute.charisma: 2, Attribute.wisom: 1};

// level up! adds 2 to charisma and 1 to wisdom.
hero.attributes += bonus;

Finally, note that we can break the Enumap down into a range when needed:

hero.attributes = hero.attributes.byValue.map!(x => x + 1);

See the full documentation of Enumap for all the operations it supports.