unixstring 0.2.3

An FFI-friendly null-terminated byte string
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

use std::{
    ffi::{CString, OsString},
    path::PathBuf,
};

use crate::UnixString;

impl From<UnixString> for CString {
    fn from(unx: UnixString) -> Self {
        let bytes = unx.into_bytes();

        // Safety: a UnixString shall never contain a zero byte except for its null terminator.
        // UnixString::into_bytes strips away the null terminator, therefore using this function is safe
        unsafe { CString::from_vec_unchecked(bytes) }
    }
}

impl From<UnixString> for OsString {
    fn from(unx: UnixString) -> Self {
        use std::os::unix::prelude::OsStringExt;

        let bytes = unx.into_bytes();

        OsString::from_vec(bytes)
    }
}

impl From<UnixString> for PathBuf {
    fn from(unx: UnixString) -> Self {
        let os_string = unx.into_os_string();

        PathBuf::from(os_string)
    }
}