unixstring

UnixString 是一个 FFI 友好的空终止字节字符串，可以由 String、CString、PathBuf、OsString 或字节数组构建。

然后可以将 UnixString 转换为 CStr、Path 或 OsStr 的切片，进行不可失败且无成本的转换操作。

为什么？

UnixString 的目的是在需要使用 FFI（特别是在 Unix 系统上与 C 交互）的任何场景中发挥作用。例如，如果您有一个 PathBuf，您可以将其数据发送给 libc 函数，如 stat，但您必须首先分配一个 CString（或类似的东西）来完成此操作。

同样，对于 OsString 和 String 也是如此，因为这些三种类型允许内部存在零字节，并且不是空终止的。

UnixString 与 CString 非常相似，但具有更高的灵活性和可用性。CString 在实例化后不能更改或增加，而 UnixString 可以通过其 push 和 push_bytes 方法进行扩展，与 OsString 有点相似。

CString 也没有直接引用转换到任何东西，只有 &[u8] 或 &CStr，而 UnixString 则有这些以及更多（下面将描述）。

从 UnixString 获取引用

创建 UnixString

从 UnixString 转换

以上所有操作也可通过 .into() 进行。

示例

使用通过 FFI 收到的字节创建 UnixString

use libc::{c_char, getcwd};
use unixstring::UnixString;

fn main() {
    const PATH_SIZ: usize = 1024;
    let mut buf: [c_char; 1024] = [0; 1024];

    let ptr = &mut buf as *mut c_char;

    unsafe { getcwd(ptr, PATH_SIZ) };

    if ptr.is_null() {
        panic!("getcwd failed");
    }

    let unix_string = unsafe { UnixString::from_ptr(ptr as *const c_char) };

    assert_eq!(unix_string.as_path(), std::env::current_dir().unwrap())
}

使用 UnixString 通过 FFI 发送字节

use std::{convert::TryFrom, env};

use unixstring::UnixString;

fn stat(path: &UnixString) -> std::io::Result<libc::stat> {
    // Safety: The all-zero byte-pattern is a valid `struct stat`
    let mut stat_buf = unsafe { std::mem::zeroed() };

    if -1 == unsafe { libc::lstat(path.as_ptr(), &mut stat_buf) } {
        let io_err = std::io::Error::last_os_error();
        Err(io_err)
    } else {
        Ok(stat_buf)
    }
}


fn main() -> std::io::Result<()>{
    for arg in env::args_os().map(UnixString::try_from).flatten() {
        let stat = stat(&arg)?;
        
        let size = stat.st_size;

        println!("{} occupies {} bytes.", arg.as_path().display(), size);
    }

    Ok(())
}