2.5. Context#

In Caterpillar, the context is a special feature that keeps track of the current packing or unpacking process. The context allows you to reference the current object being packed or parsed using the special variable this. It also provides access to the parent object, if applicable, through the variable parent.

The context is useful when defining structs that depend on other fields’ values. For example, you can reference the length of a string field and use it to define the length of another field dynamically.

Understanding the context#
@struct
class Format:
    length: uint8
    foo: CString(this.length)   # <-- just reference the length field
Understanding the context#
this = ContextPath("obj")

@struct
class Format:
    length: u8
    foo: cstring(this.length)

2.5.1. Runtime Length of Objects#

In certain cases, you may need to retrieve the runtime length of a variable within the context of the current object. The special class lenof provides this functionality. It applies the len() function to the object you’re referencing and returns the length.

2.5.2. Context Paths#

You can use context paths to access elements of a sequence or nested structures. For example, if you have a field foobar that is a sequence, you can access its elements like this:

>>> path = this.foobar[0]  # Access elements of a sequence within the current context
>>> path(context)
...