Struct binaryninja::types::StructureBuilder

pub struct StructureBuilder { /* private fields */ }

Implementations

impl StructureBuilder

// Includes
use binaryninja::types::{Structure, Type};

// Define struct, set size (in bytes)
let mut my_custom_struct = StructureBuilder::new();
let field_1 = Type::named_int(5, false, "my_weird_int_type");
let field_2 = Type::int(4, false);
let field_3 = Type::int(8, false);

// Assign those fields
my_custom_struct.append(&field_1, "field_4");
my_custom_struct.insert(&field_1, "field_1", 0);
my_custom_struct.insert(&field_2, "field_2", 5);
my_custom_struct.insert(&field_3, "field_3", 9);

// Convert structure to type
let my_custom_structure_type = Self::structure_type(&mut my_custom_struct);

// Add the struct to the binary view to use in analysis
let bv = unsafe { BinaryView::from_raw(view) };
bv.define_user_type("my_custom_struct", &my_custom_structure_type);

pub fn new() -> Self

pub fn finalize(&self) -> Ref<Structure>

pub fn set_width(&self, width: u64) -> &Self

pub fn set_alignment(&self, alignment: usize) -> &Self

pub fn set_packed(&self, packed: bool) -> &Self

pub fn set_structure_type(&self, t: StructureType) -> &Self

pub fn set_pointer_offset(&self, offset: i64) -> &Self

pub fn set_propagates_data_var_refs(&self, does: bool) -> &Self

pub fn set_base_structures(&self, bases: Vec<BaseStructure>) -> &Self

pub fn append<'a, S: BnStrCompatible, T: Into<Conf<&'a Type>>>(
    &self,
    t: T,
    name: S,
    access: MemberAccess,
    scope: MemberScope
) -> &Self

pub fn insert_member(
    &self,
    member: &StructureMember,
    overwrite_existing: bool
) -> &Self

pub fn insert<'a, S: BnStrCompatible, T: Into<Conf<&'a Type>>>(
    &self,
    t: T,
    name: S,
    offset: u64,
    overwrite_existing: bool,
    access: MemberAccess,
    scope: MemberScope
) -> &Self

pub fn with_members<'a, S: BnStrCompatible, T: Into<Conf<&'a Type>>>(
    &self,
    members: impl IntoIterator<Item = (T, S)>
) -> &Self

pub fn width(&self) -> u64

pub fn alignment(&self) -> usize

pub fn packed(&self) -> bool

pub fn structure_type(&self) -> StructureType

pub fn pointer_offset(&self) -> i64

pub fn propagates_data_var_refs(&self) -> bool

pub fn base_structures(&self) -> Result<Vec<BaseStructure>>

Trait Implementations

impl Debug for StructureBuilder

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

Formats the value using the given formatter.

impl Default for StructureBuilder

fn default() -> Self

Returns the “default value” for a type.

impl Drop for StructureBuilder

fn drop(&mut self)

Executes the destructor for this type.

impl From<&Structure> for StructureBuilder

fn from(structure: &Structure) -> StructureBuilder

Converts to this type from the input type.

impl From<Vec<StructureMember, Global>> for StructureBuilder

fn from(members: Vec<StructureMember>) -> StructureBuilder

Converts to this type from the input type.

impl Hash for StructureBuilder

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl PartialEq<StructureBuilder> for StructureBuilder

fn eq(&self, other: &StructureBuilder) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for StructureBuilder

impl StructuralEq for StructureBuilder

impl StructuralPartialEq for StructureBuilder