74 lines
1.5 KiB
Rust
74 lines
1.5 KiB
Rust
//! Foreign function interface utilities.
|
|
|
|
use crate::err::*;
|
|
pub use std::{ffi::*,
|
|
os::raw::*,
|
|
ptr::{null, null_mut}};
|
|
|
|
/// Creates a C string from a literal.
|
|
#[macro_export]
|
|
macro_rules! c_str {
|
|
($s:expr) => {
|
|
concat!($s, "\0").as_ptr() as $crate::ffi::NT
|
|
};
|
|
}
|
|
|
|
#[inline]
|
|
pub const fn null_void() -> *const c_void {null()}
|
|
|
|
#[inline]
|
|
pub const fn null_mut_void() -> *mut c_void {null_mut()}
|
|
|
|
impl CStringVec
|
|
{
|
|
/// Creates a new `CStringVec` from an iterator.
|
|
#[inline]
|
|
pub fn new_from_iter<'a, I>(it: I) -> ResultS<Self>
|
|
where I: Iterator<Item = &'a str>
|
|
{
|
|
let mut v = Self::default();
|
|
|
|
for st in it {
|
|
v.push(CString::new(st)?);
|
|
}
|
|
|
|
Ok(v)
|
|
}
|
|
|
|
/// Pushes a new `CString`.
|
|
#[inline]
|
|
pub fn push(&mut self, st: CString)
|
|
{
|
|
self.cv.insert(self.cv.len() - 1, st.as_ptr());
|
|
self.sv.push(st);
|
|
}
|
|
|
|
/// Returns the FFI pointer.
|
|
#[inline]
|
|
pub fn as_ptr(&self) -> *const NT {self.cv.as_ptr()}
|
|
|
|
/// Returns the FFI pointer mutably.
|
|
#[inline]
|
|
pub fn as_mut_ptr(&mut self) -> *mut NT {self.cv.as_mut_ptr()}
|
|
}
|
|
|
|
impl Default for CStringVec
|
|
{
|
|
/// Creates a new empty CStringVec.
|
|
#[inline]
|
|
fn default() -> Self {Self{sv: Vec::new(), cv: vec![null()]}}
|
|
}
|
|
|
|
/// An owned null-terminated string vector.
|
|
#[derive(Debug)]
|
|
pub struct CStringVec
|
|
{
|
|
sv: Vec<CString>,
|
|
cv: Vec<NT>,
|
|
}
|
|
|
|
/// A null-terminated byte string pointer.
|
|
pub type NT = *const c_char;
|
|
|
|
// EOF
|