rnet 0.3.1

Easily call into Rust from C# or other .net langauges.
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

use crate::types::{GeneratorContext, TypeDesc};
use crate::{none_ty, Net};

/// # Safety
/// This trait is implemented for Rust types which can be sent
/// to .net code.
pub unsafe trait ToNet: Net + ToNetReturn {
    #[doc(hidden)]
    const TO_DESC: &'static TypeDesc = &TypeDesc {
        marshal_out: Some(Self::gen_marshal),
        ..*Self::DESC
    };
    #[doc(hidden)]
    fn into_raw(self) -> Self::Raw;
    #[doc(hidden)]
    fn gen_marshal(ctx: &mut GeneratorContext, arg: &str) -> Box<str>;
}

/// # Safety
/// This trait is implemented for Rust types which can be used as arguments
/// to .net delegates. This is a superset of types which implement
/// `ToNet`, and allows passing types with lifetime arguments, like `&str`.
pub unsafe trait ToNetArg: Sized {
    #[doc(hidden)]
    type Owned: ToNet;
    #[doc(hidden)]
    fn to_owned(self) -> Self::Owned;
    #[doc(hidden)]
    fn to_owned_raw(self) -> <Self::Owned as Net>::Raw {
        self.to_owned().into_raw()
    }
}

/// # Safety
/// This trait is implemented for Rust types which can be used as arguments
/// to .net delegates. This is a superset of types which implement
/// `ToNet`, and allows passing types with lifetime arguments, like `&str`.
unsafe impl<T: ToNet> ToNetArg for T {
    type Owned = Self;
    fn to_owned(self) -> Self::Owned {
        self
    }
}

/// # Safety
/// This trait is implemented for Rust types which can be returned from
/// exported functions. This is a superset of types which implement `ToNet`,
/// and allows returning eg. the unit `()` type, whose .net equivalent
/// `void` cannot be used as a normal type.
pub unsafe trait ToNetReturn {
    #[doc(hidden)]
    const RETURN_DESC: &'static TypeDesc;
    #[doc(hidden)]
    type RawReturn;
    #[doc(hidden)]
    fn to_raw_return(self) -> Self::RawReturn;
}

/// # Safety
/// This trait is implemented for Rust types which can be returned from
/// exported functions. This is a superset of types which implement `ToNet`,
/// and allows returning eg. the unit `()` type, whose .net equivalent
/// `void` cannot be used as a normal type.
unsafe impl<T: ToNet> ToNetReturn for T {
    const RETURN_DESC: &'static TypeDesc = T::TO_DESC;
    type RawReturn = <Self as Net>::Raw;
    fn to_raw_return(self) -> Self::RawReturn {
        let raw = self.into_raw();

        // Transmute necessary because rustc can't figure out that the
        // types are the same...
        unsafe { std::mem::transmute_copy(&raw) }
    }
}

unsafe impl ToNetReturn for () {
    const RETURN_DESC: &'static TypeDesc = &TypeDesc {
        net_ty: none_ty,
        base_ty: none_ty,
        raw_ty: none_ty,
        marshal_in: None,
        marshal_out: Some(|_, arg| arg.into()),
    };
    type RawReturn = ();

    fn to_raw_return(self) -> Self::RawReturn {}
}