better enums

Bessere Aufzählungen

Reflektierende Enum-Bibliothek zur Kompilierungszeit mit sauberer Syntax, in einer einzigen Header-Datei und ohne Abhängigkeiten.

In C++11 kann alles zur Kompilierzeit verwendet werden. Sie können Ihre Aufzählungen konvertieren, sie durchlaufen, ihr Maximum ermitteln, Konventionen statisch erzwingen und die Ergebnisse als Vorlagenargumente oder an constexpr -Funktionen weitergeben. Die gesamte Reflexion steht für Ihre Metaprogrammierungsanforderungen zur Verfügung.

Die Schnittstelle ist für C++98 dieselbe – Sie müssen sie nur größtenteils zur Laufzeit verwenden. Diese Bibliothek stellt Aufzählungen mit Gültigkeitsbereich und Größe bereit, was in C++98 nicht integriert ist.

Die vollständige Dokumentation finden Sie auf der Projektseite.

Installation

Fügen Sie einfach enum.h zu Ihrem Projekt hinzu.

Zusätzliche Funktionen

• Verwendet nur Standard-C++, für C++98 ist jedoch verschiedene Makrounterstützung erforderlich (große Compiler verfügen über diese).
• Unterstützt und getestet auf Clang, GCC und MSVC.
• Schnelle Zusammenstellung. Sie müssen ein paar Dutzend Enumerationen deklarieren, um Ihren Compiler so stark zu verlangsamen, wie es nur durch die Einbeziehung von iostream der Fall ist.
• Verwenden Sie beliebige Initialisierer und Sparse-Bereiche, genau wie bei einer integrierten Enumeration.
• Kontrolle über Größe und Ausrichtung – Sie wählen den Darstellungstyp.
• Stream-Betreiber.
• Verwendet den Heap nicht und kann mit deaktivierten Ausnahmen kompiliert werden, um in minimalen freistehenden Umgebungen verwendet zu werden.

Einschränkungen

1. Die größte Einschränkung besteht darin, dass das BETTER_ENUM -Makro nicht innerhalb einer Klasse verwendet werden kann. Dies scheint schwierig zu entfernen. Es gibt eine Problemumgehung mit typedef (oder 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;

   Sie können BETTER_ENUM jedoch innerhalb eines Namespace verwenden.

2. Das Makro hat eine weiche Grenze von 64 deklarierten Konstanten. Sie können es erweitern, indem Sie dieser Anleitung folgen. Letztendlich wird die Anzahl der Konstanten durch die maximale Anzahl der Makroargumente Ihres Compilers begrenzt.

3. In manchen Fällen ist es notwendig, Konstanten wie Channel::Red ein + voranzustellen, um sie explizit zum Typ Channel heraufzustufen. Wenn Sie beispielsweise einen Vergleich durchführen:

   channel == +Channel::Red

4. Auf msvc müssen Sie möglicherweise die Warnung C4062 aktivieren, um eine Vollständigkeitsprüfung switch Groß- und Kleinschreibung zu erhalten.

Geschichte

Die Originalversion der Bibliothek wurde vom Autor im Winter 2012-2013 bei Hudson River Trading als Ersatz für einen älteren Generator namens BETTER_ENUM entwickelt.