3.2. Data Model

Structs serve as the foundation of this library. All data within the framework undergoes the process of packing and unpacking using structs or _StructLike objects. There are three possible types of structs:

• Sequences:

  These structs operate independently of fields, making them field-agnostic. As such, they do not need to be attached to a Field instance. Typically, they are are combined with specific requirements, which will be discussed later on.

• Primitive Structs:

  All defined primitive structs depent on being linked to a Field instance. They are designed to incorporate all attributes that can be set on a field.

• Partial Structs:

  For scenarios where selective functionality is paramount, it is recommended to implement structs that focus solely on parsing, writing, or the calculation of the struct’s size. These specialized structs, referred to as partial structs, provide a modular approach for extending the library. Consideration of partial structs is essential when aiming to extend the capabilities of this framework.

Standard Data Model

• 3.2.1. Standard Types
  • 3.2.1.1. Sequence
  • 3.2.1.2. Struct
  • 3.2.1.3. Union
  • 3.2.1.4. Bit-field
    • Concept
    • Syntax
    • Processing Rules
  • 3.2.1.5. Templates

Caterpillar-specific Protocols

• 3.2.2. Caterpillar’s Protocols
  • 3.2.2.1. Action-like Objects
  • 3.2.2.2. Context-like Objects
  • 3.2.2.3. Context Lambdas
  • 3.2.2.4. Struct-Like Objects
  • 3.2.2.5. Bit-field Extensions
  • 3.2.2.6. Byteorder Extensions