2.42.0 (latest) 2.41.0 2.40.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.0 2.33.0 2.32.0 2.31.0 2.30.1 2.29.0 2.28.1 2.26.0 2.25.0 2.24.0 2.23.1 2.22.0 2.21.0 2.20.0 2.19.0 2.18.1 2.17.0 2.16.0 2.15.0 2.14.1 2.13.2 2.12.0 2.11.3 2.10.1 2.9.0 2.8.1 2.7.1 2.6.0 2.5.2 2.4.0 2.3.3 2.2.0 2.1.0 2.0.0 1.7.3 1.6.1 1.5.1 1.4.0 1.3.0 1.2.1 1.1.0 1.0.0 0.34.0

    OrderedCodeBytes(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Fields are encoded independently and concatenated with the fixed
byte pair {0x00, 0x01} in between.

Any null (0x00) byte in an encoded field is replaced by the fixed
byte pair {0x00, 0xFF}.

Fields that encode to the empty string "" have special handling:

- If *every* field encodes to "", or if the STRUCT has no fields defined, then the STRUCT is encoded as the fixed byte pair {0x00, 0x00}.
- Otherwise, the STRUCT only encodes until the last non-empty field, omitting any trailing empty fields. Any empty fields that aren't omitted are replaced with the fixed byte pair {0x00, 0x00}.

Examples:

- STRUCT() -\> "\\00\\00"
- STRUCT("") -\> "\\00\\00"
- STRUCT("", "") -\> "\\00\\00"
- STRUCT("", "B") -\> "\\00\\00" + "\\00\\01" + "B"
- STRUCT("A", "") -\> "A"
- STRUCT("", "B", "") -\> "\\00\\00" + "\\00\\01" + "B"
- STRUCT("A", "", "C") -\> "A" + "\\00\\01" + "\\00\\00" + "\\00\\01"
  - "C"

Since null bytes are always escaped, this encoding can cause size
blowup for encodings like `Int64.BigEndianBytes` that are likely
to produce many such bytes.

Sorted mode:

- Fields are encoded in sorted mode.
- All values supported by the field encodings are allowed
- Element-wise order is preserved: `A < B` if `A[0] < B[0]`, or if `A[0] == B[0] && A[1] < B[1]`, etc. Strict prefixes sort first.

Distinct mode:

- Fields are encoded in distinct mode.
- All values supported by the field encodings are allowed.