better enums

Лучшие перечисления

Рефлексивная библиотека перечислений времени компиляции с чистым синтаксисом, в одном заголовочном файле и без зависимостей.

В C++11 все можно использовать во время компиляции. Вы можете конвертировать перечисления, перебирать их, находить их максимум, статически применять соглашения и передавать результаты в качестве аргументов шаблона или в функции constexpr . Все отражения доступны для ваших нужд метапрограммирования.

Интерфейс для C++98 такой же — вам просто придется использовать большую его часть только во время выполнения. Эта библиотека предоставляет перечисления с ограниченной областью действия и размером, чего нет в C++98.

Полную документацию смотрите на странице проекта.

Установка

Просто добавьте enum.h в свой проект.

Дополнительные возможности

• Использует только стандартный C++, однако для C++98 требуется поддержка переменных макросов (она есть в основных компиляторах).
• Поддерживается и тестируется на clang, gcc и msvc.
• Быстрая компиляция. Вам придется объявить несколько десятков перечислений, чтобы замедлить работу вашего компилятора так же, как это делает только включение iostream .
• Используйте любые инициализаторы и разреженные диапазоны, как и в случае встроенного перечисления.
• Контроль над размером и выравниванием — вы сами выбираете тип представления.
• Потоковые операторы.
• Не использует кучу и может быть скомпилирован с отключенными исключениями для использования в минимальных автономных средах.

Ограничения

1. Самым большим ограничением является то, что макрос BETTER_ENUM нельзя использовать внутри класса. Кажется, это трудно удалить. Существует обходной путь с помощью typedef (или C++11 using ):

    BETTER_ENUM (SomePrefix_Color, uint8_t , Red, Green, Blue)
   
   struct triplet {
       typedef SomePrefix_Color    Color;
       Color                       r, g, b;
   };
   
   triplet::Color  color;

   Однако вы можете использовать BETTER_ENUM внутри пространства имен.

2. Макрос имеет мягкое ограничение в 64 объявленных константы. Вы можете продлить его, следуя этим инструкциям. В конечном итоге количество констант ограничено максимальным количеством аргументов макроса вашего компилятора.

3. В некоторых случаях необходимо добавлять к константам, таким как Channel::Red , префикс + чтобы явно преобразовать их в тип Channel . Например, если вы выполняете сравнение:

   channel == +Channel::Red

4. В msvc вам может потребоваться включить предупреждение C4062, чтобы обеспечить проверку полноты регистра switch .

История

Оригинальная версия библиотеки была разработана автором зимой 2012-2013 года в компании Hudson River Trading, как замена более старому генератору под названием BETTER_ENUM .