Struct lde::OcBuilder

pub struct OcBuilder { /* fields omitted */ }

Opcode builder.

Conveniently write new opcodes by their byte representation.

Methods

impl OcBuilder

pub fn new(len: usize) -> OcBuilder

Create a new opcode of specified length, clamped to 15.

The opcode is initialized to all zeroes.

pub fn write<T: Int>(self, offset: usize, val: T) -> OcBuilder

Helps writing immediate and displacement values.

Examples

let result = lde::OcBuilder::from(b"\xE8****").write(1, 0x01010101_u32);
assert_eq!(*result, b"\xE8\x01\x01\x01\x01");

Panics

Panics if offset..offset + sizeof(T) is out of bounds.

Methods from Deref<Target = OpCode>

pub fn read<T: Int>(&self, offset: usize) -> T

Helps reading immediate and displacement values.

Examples

// mov eax, 0x01010101
let opcode: &lde::OpCode = b"\xB8\x01\x01\x01\x01".into();

// reads the immedate value
let result = opcode.read::<u32>(1);

assert_eq!(result, 0x01010101);

Panics

Panics if offset..offset + sizeof(T) is out of bounds.

pub fn write<T: Int>(&mut self, offset: usize, val: T) -> &mut OpCode

Helps writing immediate and displacement values.

Examples

// mov al, 1
let mut opcode = [0xb0, 0x01];
let opcode: &mut lde::OpCode = (&mut opcode).into();

// change the immediate to 0xff
opcode.write(1, 0xff_u8);

assert_eq!(opcode, &[0xb0, 0xff]);

Panics

Panics if offset..offset + sizeof(T) is out of bounds.

Trait Implementations

impl Copy for OcBuilder

impl Clone for OcBuilder

fn clone(&self) -> OcBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for OcBuilder

fn default() -> OcBuilder

Returns the "default value" for a type.

impl Eq for OcBuilder

impl PartialEq for OcBuilder

fn eq(&self, __arg_0: &OcBuilder) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, __arg_0: &OcBuilder) -> bool

This method tests for !=.

impl Hash for OcBuilder

fn hash<__H: Hasher>(&self, __arg_0: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<T: AsRef<[u8]>> From<T> for OcBuilder

Converts a template byte slice to an opcode builder.

The input length is clamped to 15 bytes.

fn from(val: T) -> OcBuilder

Performs the conversion.

impl Deref for OcBuilder

type Target = OpCode

The resulting type after dereferencing.

fn deref(&self) -> &OpCode

Dereferences the value.

impl DerefMut for OcBuilder

fn deref_mut(&mut self) -> &mut OpCode

Mutably dereferences the value.

impl Debug for OcBuilder

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Display for OcBuilder

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.