Struct PropertyPtrBuilder 

pub struct PropertyPtrBuilder { /* private fields */ }

Builder for constructing PropertyPtr table entries

Provides a fluent interface for building PropertyPtr metadata table entries. These entries provide indirection for property access when logical and physical property ordering differs, enabling metadata optimizations and compressed layouts.

Required Fields

• property: Property table RID that this pointer references

Indirection Context

The PropertyPtr table provides a mapping layer between logical property references and physical Property table entries. This enables:

• Property reordering for metadata optimization
• Compressed metadata streams with flexible property organization
• Runtime property access pattern optimizations
• Edit-and-continue property modifications without breaking references

Examples

use dotscope::prelude::*;

// Create property pointer for property reordering
let ptr1 = PropertyPtrBuilder::new()
    .property(9)  // Points to Property table entry 9
    .build(&mut context)?;

// Create pointer for optimized property layout
let ptr2 = PropertyPtrBuilder::new()
    .property(4)  // Points to Property table entry 4
    .build(&mut context)?;

// Multiple pointers for complex property arrangements
let ptr3 = PropertyPtrBuilder::new()
    .property(18) // Points to Property table entry 18
    .build(&mut context)?;

Implementations

impl PropertyPtrBuilder

pub fn new() -> Self

Creates a new PropertyPtrBuilder with default values

Initializes a new builder instance with all fields unset. The caller must provide the required property RID before calling build().

Returns

A new PropertyPtrBuilder instance ready for configuration

Examples

use dotscope::prelude::*;

let builder = PropertyPtrBuilder::new();

pub fn property(self, property: u32) -> Self

Sets the Property table RID

Specifies which Property table entry this pointer references. This creates the indirection mapping from the PropertyPtr RID (logical index) to the actual Property table entry (physical index).

Parameters

• property: The Property table RID to reference

Returns

Self for method chaining

Examples

use dotscope::prelude::*;

// Point to first property
let builder = PropertyPtrBuilder::new()
    .property(1);

// Point to a later property for reordering
let builder = PropertyPtrBuilder::new()
    .property(15);

pub fn build(self, assembly: &mut CilAssembly) -> Result<ChangeRefRc>

Builds and adds the PropertyPtr entry to the metadata

Validates all required fields, creates the PropertyPtr table entry, and adds it to the assembly. Returns a token that can be used to reference this property pointer entry.

Parameters

• assembly: Mutable reference to the CilAssembly

Returns

• Ok(Token): Token referencing the created property pointer entry
• Err(Error): If validation fails or table operations fail

Errors

• Missing required field (property RID)
• Table operations fail due to metadata constraints

Examples

use dotscope::prelude::*;

let mut assembly = CilAssembly::new(view);
let token = PropertyPtrBuilder::new()
    .property(6)
    .build(&mut assembly)?;

Trait Implementations

impl Clone for PropertyPtrBuilder

fn clone(&self) -> PropertyPtrBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PropertyPtrBuilder

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

Formats the value using the given formatter.

impl Default for PropertyPtrBuilder

fn default() -> Self

Creates a default PropertyPtrBuilder

Equivalent to calling PropertyPtrBuilder::new().