netcorehost 0.20.1

A Rust library for hosting the .NET Core runtime.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110

use std::{collections::HashMap, mem::MaybeUninit, ptr};

use crate::{
    error::{HostingError, HostingResult},
    pdcstring::PdCStr,
};

use super::HostfxrContext;

impl<I> HostfxrContext<I> {
    /// Gets the runtime property value for the given key of this host context.
    pub fn get_runtime_property_value(
        &self,
        name: impl AsRef<PdCStr>,
    ) -> Result<&'_ PdCStr, HostingError> {
        let mut value = MaybeUninit::uninit();

        let result = unsafe {
            self.library().hostfxr_get_runtime_property_value(
                self.handle().as_raw(),
                name.as_ref().as_ptr(),
                value.as_mut_ptr(),
            )
        }
        .unwrap();
        HostingResult::from(result).into_result()?;

        Ok(unsafe { PdCStr::from_str_ptr(value.assume_init()) })
    }

    /// Sets the value of a runtime property for this host context.
    pub fn set_runtime_property_value(
        &mut self,
        name: impl AsRef<PdCStr>,
        value: impl AsRef<PdCStr>,
    ) -> Result<(), HostingError> {
        let result = unsafe {
            self.library().hostfxr_set_runtime_property_value(
                self.handle().as_raw(),
                name.as_ref().as_ptr(),
                value.as_ref().as_ptr(),
            )
        }
        .unwrap();
        HostingResult::from(result).into_result().map(|_| ())
    }

    /// Remove a runtime property for this host context.
    pub fn remove_runtime_property_value(
        &mut self,
        name: impl AsRef<PdCStr>,
    ) -> Result<(), HostingError> {
        let result = unsafe {
            self.library().hostfxr_set_runtime_property_value(
                self.handle().as_raw(),
                name.as_ref().as_ptr(),
                ptr::null(),
            )
        }
        .unwrap();
        HostingResult::from(result).into_result().map(|_| ())
    }

    /// Get all runtime properties for this host context.
    pub fn runtime_properties(&self) -> Result<HashMap<&'_ PdCStr, &'_ PdCStr>, HostingError> {
        // get count
        let mut count = MaybeUninit::uninit();
        let mut result = unsafe {
            self.library().hostfxr_get_runtime_properties(
                self.handle().as_raw(),
                count.as_mut_ptr(),
                ptr::null_mut(),
                ptr::null_mut(),
            )
        }
        .unwrap();

        // ignore buffer too small error as the first call is only to get the required buffer size.
        match HostingResult::from(result).into_result() {
            Ok(_) | Err(HostingError::HostApiBufferTooSmall) => {}
            Err(e) => return Err(e),
        }

        // get values / fill buffer
        let mut count = unsafe { count.assume_init() };
        let mut keys = Vec::with_capacity(count);
        let mut values = Vec::with_capacity(count);
        result = unsafe {
            self.library().hostfxr_get_runtime_properties(
                self.handle().as_raw(),
                &raw mut count,
                keys.as_mut_ptr(),
                values.as_mut_ptr(),
            )
        }
        .unwrap();
        HostingResult::from(result).into_result()?;

        unsafe { keys.set_len(count) };
        unsafe { values.set_len(count) };

        let keys = keys.into_iter().map(|e| unsafe { PdCStr::from_str_ptr(e) });
        let values = values
            .into_iter()
            .map(|e| unsafe { PdCStr::from_str_ptr(e) });

        let map = keys.zip(values).collect();
        Ok(map)
    }
}