lisy 0.1.0

Linux specific high and middle level system level API library.
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

use std::ffi::{CStr, CString, OsStr, OsString};
use std::io;
use std::os::unix::ffi::OsStrExt;
use std::path::{Path, PathBuf};

use crate::error::io_format_err;

#[allow(dead_code)]
#[inline]
pub(crate) fn io_c_string<T: Into<Vec<u8>>>(t: T) -> io::Result<CString> {
    CString::new(t).map_err(|_| io_format_err!("null byte in path"))
}

#[allow(dead_code)]
#[inline]
pub(crate) fn io_c_os_str(s: &OsStr) -> io::Result<CString> {
    io_c_string(s.as_bytes())
}

/// Path helper for minimal copying when generating C-Strings.
///
/// This maps [`NulError`](std::ffi::NulError) to `io::ErrorKind::Unknown`.
pub trait CPath {
    /// Call `func` with a `CStr` version of `self`.
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R;
}

impl CPath for PathBuf {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        self.as_os_str().c_path(func)
    }
}

impl CPath for Path {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        self.as_os_str().c_path(func)
    }
}

impl CPath for OsString {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        self.as_os_str().c_path(func)
    }
}

impl CPath for OsStr {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        Ok(func(&io_c_string(self.as_bytes())?))
    }
}

impl CPath for String {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        AsRef::<OsStr>::as_ref(self).c_path(func)
    }
}

impl CPath for str {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        AsRef::<OsStr>::as_ref(self).c_path(func)
    }
}

impl CPath for CStr {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        Ok(func(self))
    }
}

impl CPath for CString {
    fn c_path<R, F>(&self, func: F) -> io::Result<R>
    where
        F: FnOnce(&CStr) -> R,
    {
        Ok(func(self))
    }
}