Struct cranelift_codegen_meta::isa::x86::recipes::Template

pub(crate) struct Template<'builder> {
    regs: &'builder IsaRegs,
    recipe: EncodingRecipeBuilder,
    rex_kind: RexRecipeKind,
    inferred_rex_compute_size: Option<&'static str>,
    when_prefixed: Option<Rc<Template<'builder>>>,
    w_bit: u16,
    rrr_bits: u16,
    op_bytes: &'static [u8],
}

Previously called a TailRecipe in the Python meta language, this allows to create multiple variants of a single base EncodingRecipe (rex prefix, specialized w/rrr bits, different opcodes). It serves as a prototype of an EncodingRecipe, which is then used when actually creating Encodings, in encodings.rs. This is an idiosyncrasy of the x86 meta-language, and could be reconsidered later.

Fields

regs: &'builder IsaRegs

Description of registers, used in the build() method.

recipe: EncodingRecipeBuilder

The recipe template, which is to be specialized (by copy).

rex_kind: RexRecipeKind

How is the REX prefix emitted?

inferred_rex_compute_size: Option<&'static str>

Function for compute_size() when REX is inferrable.

when_prefixed: Option<Rc<Template<'builder>>>

Other recipe to use when REX-prefixed.

w_bit: u16

Value of the W bit (0 or 1), stored in the EncodingBits.

rrr_bits: u16

Value of the RRR bits (between 0 and 0b111).

op_bytes: &'static [u8]

Opcode bytes.

Methods

impl<'builder> Template<'builder>

fn new(recipe: EncodingRecipeBuilder, regs: &'builder IsaRegs) -> Self

fn name(&self) -> &str

fn rex_kind(self, kind: RexRecipeKind) -> Self

fn inferred_rex_compute_size(self, function: &'static str) -> Self

fn when_prefixed(self, template: Rc<Template<'builder>>) -> Self

pub fn opcodes(&self, op_bytes: &'static [u8]) -> Self

pub fn w(&self) -> Self

pub fn rrr(&self, value: u16) -> Self

pub fn nonrex(&self) -> Self

pub fn rex(&self) -> Self

pub fn infer_rex(&self) -> Self

pub fn build(self) -> (EncodingRecipe, u16)

Trait Implementations

impl<'builder> Clone for Template<'builder>

fn clone(&self) -> Template<'builder>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.