libstrophe 0.20.3

Rust ergonomic wrapper for libstrophe
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
101

use core::ffi::{CStr, c_char};
use core::ptr;
use std::ffi::CString;

#[allow(clippy::upper_case_acronyms)]
pub struct FFI<T>(pub T);

impl FFI<&str> {
	#[inline]
	pub fn send(self) -> CString {
		CString::new(self.0).expect("Cannot convert to CString")
	}
}

impl<T: num_traits::Zero + PartialEq> FFI<T> {
	#[inline]
	pub fn receive_bool(self) -> bool {
		self.0 != T::zero()
	}
}

impl FFI<*const c_char> {
	/// The lifetime of the returned reference is bound to "lifetime" of the pointer
	#[inline]
	pub unsafe fn receive<'s>(self) -> Option<&'s str> {
		unsafe { self.0.as_ref() }.map(|x| {
			unsafe { CStr::from_ptr(x) }
				.to_str()
				.expect("Cannot convert non-null pointer into &str")
		})
	}
}

impl FFI<*mut c_char> {
	#[inline]
	pub unsafe fn receive_with_free(self, free: impl FnOnce(*mut c_char)) -> Option<String> {
		unsafe { self.0.as_mut() }.map(|x| {
			let out = unsafe { CStr::from_ptr(x) }
				.to_owned()
				.into_string()
				.expect("Cannot convert non-null pointer into String");
			free(x);
			out
		})
	}
}

impl FFI<Option<&str>> {
	#[inline]
	pub fn send(self) -> Nullable<CString> {
		match self.0 {
			None => Nullable::Null,
			Some(v) => Nullable::Val(FFI(v).send()),
		}
	}
}

pub enum Nullable<T> {
	Null,
	Val(T),
}

impl Nullable<CString> {
	#[inline]
	pub fn as_ptr(&self) -> *const c_char {
		match *self {
			Nullable::Null => ptr::null(),
			Nullable::Val(ref v) => v.as_ptr(),
		}
	}
}

impl<T: num_traits::Zero> Nullable<T> {
	#[inline]
	pub fn val(self) -> T {
		match self {
			Nullable::Null => T::zero(),
			Nullable::Val(v) => v,
		}
	}
}

impl<T> From<Option<T>> for Nullable<T> {
	#[inline]
	fn from(f: Option<T>) -> Self {
		match f {
			None => Nullable::Null,
			Some(v) => Nullable::Val(v),
		}
	}
}

//impl<T> Into<Option<T>> for Nullable<T> {
//	#[inline]
//	fn into(self) -> Option<T> {
//		match self {
//			Nullable::Null => Option::None,
//			Nullable::Val(v) => Option::Some(v)
//		}
//	}
//}