Struct VirtualVariableFile 

pub struct VirtualVariableFile { /* private fields */ }

Virtual representation of a service’s variable file

This abstraction allows both local memory-mapped files and remote WSS-synced files to be accessed through a unified interface. The file maintains:

• Current variable data in memory
• Metadata about variable locations and sizes
• A shadow copy for change detection
• Per-variable change tracking

Implementations

impl VirtualVariableFile

pub fn new(service_id: String, service_name: String, tenant_id: String) -> Self

Create a new virtual variable file

pub fn service_id(&self) -> &str

Get service ID

pub fn service_name(&self) -> &str

Get service name

pub fn tenant_id(&self) -> &str

Get tenant ID

pub async fn register_variable(&self, metadata: VariableMetadata) -> Result<()>

Register a variable

pub async fn get_variable_metadata( &self, name: &str, ) -> Result<VariableMetadata>

Get variable metadata by name

pub async fn list_variables(&self) -> Result<Vec<VariableMetadata>>

List all variables

pub async fn read_variable_slice(&self, name: &str) -> Result<Vec<u8>>

Read a variable as zero-copy slice

pub async fn write_variable(&self, name: &str, data: &[u8]) -> Result<()>

Write a variable

pub async fn bytes(&self) -> Vec<u8>

Get raw bytes (zero-copy reference to internal buffer)

pub async fn update_bytes(&self, data: Vec<u8>) -> Result<()>

Update entire file content

pub async fn shadow_bytes(&self) -> Vec<u8>

Get shadow copy

pub async fn update_shadow_bytes(&self, data: Vec<u8>) -> Result<()>

Update shadow copy

pub async fn get_changed_variables(&self) -> Vec<String>

Get list of changed variables since last sync

pub async fn clear_changes(&self)

Clear change tracking

pub async fn mark_variables_changed(&self, names: Vec<String>)

Mark specific variables as changed

pub async fn compare_ranges( current: &[u8], shadow: &[u8], ) -> Result<Vec<(u64, u64)>>

Compare two byte ranges using wide SIMD operations

Returns byte offsets where differences were found

pub async fn find_changed_variables_from_diff( &self, diff_ranges: &[(u64, u64)], ) -> Result<Vec<String>>

Find which variables changed based on byte differences

pub async fn sync_shadow(&self) -> Result<()>

Sync shadow with current (after sending updates to server)

Trait Implementations

impl Debug for VirtualVariableFile

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

Formats the value using the given formatter.