Struct RustClr 

pub struct RustClr<'a> { /* private fields */ }

Represents a Rust interface to the Common Language Runtime (CLR).

Example

use rustclr::{RustClr, RuntimeVersion};
use std::fs;
 
// Load a sample .NET assembly into a buffer
let buffer = fs::read("examples/sample.exe")?;
let mut clr = RustClr::new(&buffer)?
    .with_runtime_version(RuntimeVersion::V4)
    .with_domain("CustomDomain")
    .with_args(vec!["arg1", "arg2"])
    .with_output();
 
let output = clr.run()?;
println!("Output: {}", output);

Implementations

impl<'a> RustClr<'a>

pub fn new<T: Into<ClrSource<'a>>>(source: T) -> Result<Self>

Creates a new RustClr.

Errors

Returned when the file cannot be read or when the buffer does not represent a valid .NET executable.

pub fn with_runtime_version(self, version: RuntimeVersion) -> Self

Sets the .NET runtime version to use.

pub fn with_domain(self, domain_name: &str) -> Self

Sets the application domain name.

pub fn with_args(self, args: Vec<&str>) -> Self

Sets arguments to be passed to the assembly’s entry point.

pub fn with_output(self) -> Self

Enables or disables output redirection.

pub fn with_patch_exit(self) -> Self

Enables patching of the System.Environment.Exit method in mscorlib.

pub fn run(&mut self) -> Result<String>

Loads the .NET assembly and runs its entry point.

Errors

Returned when CLR initialization fails, when the assembly cannot be loaded, when Main cannot be invoked, or when output capture is enabled but fails.

Trait Implementations

impl<'a> Clone for RustClr<'a>

fn clone(&self) -> RustClr<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RustClr<'a>

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

Formats the value using the given formatter.

impl<'a> Default for RustClr<'a>

fn default() -> RustClr<'a>

Returns the “default value” for a type.

impl Drop for RustClr<'_>

fn drop(&mut self)

Executes the destructor for this type.