Enumerated Type

Another facet that is frequently applied to XSD string-based types is enumeration. This results in the generation of a C enum typedef that enumerates all of the identifiers that can be used in the type. The actual C typedef that is generated for the item is of type OSUINT16. The reasons for not directly using the generated enum type are:

The general mapping is as follows:

XSD type:

   <xsd:simpleType name="TypeName">
      <restriction base="xsd:string">
         <xsd:enumeration value="enum1"/>
         <xsd:enumeration value="enum2"/>
         ...
         <xsd:enumeration value="enumN"/>
      </xsd:restriction>
   </xsd:simpleType>

Generated C code:

   typedef enum {
      TypeName_enum1 = 0,
      TypeName_enum2 = 1,
      ...
      TypeName_enumN = N - 1,
   } TypeName_ENUM;

   typedef OSUINT16 TypeName;

Generated C++ code:

   class TypeName : public OSRTBaseType {
     public:
      enum {
         enum1 = 0,
         enum2 = 1,
         ...
         enumN = N - 1,
      } ;

      OSUINT16 value;
      ...
   } ;

Note that for C, TypeNameis used on the enumerated identifiers as a namespace mechanism in order to prevent name clashes if two or more enumerated types use the same identifier names. In this case, the type name may only be a partial fragment of the full name to keep the names shorter. This is not a problem in C++ as the class provides a namespace for the enumeration constants defined within (for example, enum1would be referenced as TypeName::enum1outside the class).

In XSD, the rules for naming enumerated identifiers are more liberal than in the C/C++ programming language. For example, enumerated identifiers can start with numbers or punctuation marks. The logic to transform the XSD enumeration names to C/C++ form makes use of the following rules to ensure the names are valid C/C++ names:

  1. If all items are numeric, no symbolic identifiers are generated. The user is expected to work with the items in numeric form.

  2. If an enumeration identifier consists of whitespace (for example, enumeration value=" "), the special name BLANK is used.

  3. Other special names are used for other single punctuation mark identifiers (for example, '+' = PLUS).

  4. If after applying these rules, the name still has a non-alphabetic start character, the character 'x' is prepended.

  5. All invalid C/C++ identifier characters are replaced with underscores (_) within the name.