This module contains implementations for most common operand usages.

These operands are usually added to objects such as ArchInstruction when disassembling a binary.

ProxyFeeder gives an interface for operands which aim to provide a dynamic content.

A typical class declaration for a new implementation looks like:

    class NewImplem(GObject.Object, ProxyFeeder):
        ...

The following methods have to be defined for new implementations:

• _compare();
• _print();

The object can be compared using rich methods (like <= or !=).

The RenameableOperand interface depicts operands which can get renamed with an alternative text.

A typical class declaration for a new implementation looks like:

    class NewImplem(GObject.Object, RenameableOperand):
        ...

The following method has to be defined for new implementations:

• _build();

The RenamedOperand interface depicts operands renamed with an alternative text.

A typical class declaration for a new implementation looks like:

    class NewImplem(GObject.Object, RenamedOperand):
        ...

The following method has to be defined for new implementations:

• _get_text();

The TargetableOperand interface depicts operands which can drive to another location.

By instance, an immediate value can target a given address into some function code.

A typical class declaration for a new implementation looks like:

    class NewImplem(GObject.Object, TargetableOperand):
        ...

The following method has to be defined for new implementations:

• _get_addr();

The ImmOperand deals with immediate value as operand.

There are several ways to display these values in a disassembly, the operand handles that.

Instances can be created using the following constructor:

    ImmOperand(size, value)

Where size specifies the original size of the provided value, as a MemoryDataSize.

The KnownImmOperand provides replacement of ImmOperand instances by an alternative text.

Instances can be created using the following constructor:

    KnownImmOperand(imm, alt)

Where imm is an operand of type ImmOperand and alt is a string providing the text to be rendered at object display.

The object can be compared using rich methods (like <= or !=).

The ProxyOperand object behaves like a proxy operand for an object which can feed the operand with content.

Instances can be created using the following constructor:

    ProxyOperand(feeder)

Where feeder is an instance implementing the ProxyFeeder interface.

The RegisterOperand object handles an operand carrying an architecture register.

Instances can be created using the following constructor:

    RegisterOperand(reg)

Where reg is an architecture register defined from a subclass of ArchRegister.

The TargetOperand object translates immediate values as symbols.

Instances can be created using the following constructor:

    TargetOperand(size, addr)

Where size is a MemoryDataSize value describing the size of memory addresses and addr is the location of a symbol to target, as a vmpa value.