rappct 0.13.3

Rust AppContainer / LPAC toolkit for Windows (profiles, capabilities, process launch, diagnostics).
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

//! Owned wide (UTF-16) string helpers for FFI.

use windows::core::{PCWSTR, PWSTR};

/// NUL-terminated UTF-16 buffer for stable FFI pointers.
#[derive(Debug, Clone)]
pub(crate) struct WideString {
    buf: Vec<u16>,
}
impl WideString {
    #[allow(dead_code)]
    pub(crate) fn from_os_str(s: &std::ffi::OsStr) -> Self {
        use std::os::windows::ffi::OsStrExt;
        let mut v: Vec<u16> = s.encode_wide().collect();
        v.push(0);
        Self { buf: v }
    }

    pub(crate) fn from_str(s: &str) -> Self {
        use std::os::windows::ffi::OsStrExt;
        let mut v: Vec<u16> = std::ffi::OsStr::new(s).encode_wide().collect();
        v.push(0);
        Self { buf: v }
    }

    pub(crate) fn as_pcwstr(&self) -> PCWSTR {
        PCWSTR(self.buf.as_ptr())
    }

    #[allow(dead_code)]
    pub(crate) fn as_pwstr(&mut self) -> PWSTR {
        PWSTR(self.buf.as_mut_ptr())
    }
}

#[cfg(test)]
#[cfg(windows)]
mod tests {
    use super::*;

    #[test]
    fn wide_from_str_is_nul_terminated() {
        let w = WideString::from_str("abc");
        assert_eq!(w.buf.last().copied(), Some(0));
        assert_eq!(&w.buf[..w.buf.len() - 1], &[97u16, 98, 99]);
        let _p = w.as_pcwstr();
    }
}