pub trait Nullable {
    const NULL: Self;

    fn is_null(&self) -> bool;
}

null_pointer_check!() 允许您检查某个特定的事物是否无效，设置 LAST_ERROR，并使用 Nullable::NULL 早期从当前函数返回。

实际上，这使得处理无效输入的可能性变得相当方便。

struct Foo {
  data: Vec<u8>,
}

#[no_mangle]
unsafe extern "C" fn foo_get_data(foo: *const Foo) -> *const u8 {
    null_pointer_check!(foo);

    let foo = &*foo;
    foo.data.as_ptr()
}

异常安全性

当一段Rust代码崩溃并尝试跨越FFI边界回溯时，异常安全性成为一个问题。目前这会导致程序中止，虽然不再是直接的 未定义行为，但这仍然是一个非常麻烦的问题。

存在一个 catch_panic() 函数，它允许您执行一些代码并将捕获任何回溯，适当更新 LAST_ERROR。宏 catch_panic!() 使这变得更容易一些，并且与 Nullable 特性一起工作，因此您可以从函数中退出，返回错误（Nullable::NULL）。

将闭包拆分为数据和代码

对于与回调一起工作的FFI函数来说，接受一个额外的 void *user_data 参数，该参数指向用户可能想要使用的任何额外状态，这是相当常见的。这并不允许程序员使用

可以使用 split_closure() 函数将闭包指针“拆分”为其数据的指针和一个 unsafe extern "C" fn()，它可以用作回调。

Rust闭包通过生成一个自定义类型来包含任何捕获的状态，并为 FnMut()（或 Fn()，或 FnOnce()）实现。此函数通过将闭包指针强制转换为 void *（这是我们的数据）来工作（这是我们的数据），并定义一个trampoline函数，该函数将数据转换回并调用闭包。

fn split<C>(closure: &mut C) -> (*mut c_void, unsafe extern "C" fn(*mut c_void))
where C: FnMut()
{
    unsafe extern "C" fn trampoline<T>(user_data: *mut c_void) {
        let closure: &mut T = &mut *(user_data as *mut T);

        closure();
    }

    (closure as *mut C as *mut c_void, trampoline::<T>)
}

pub trait Task: Send + Sync + Clone {
    type Output: Send + Sync;
    fn run(&self, cancel_tok: &CancellationToken) -> Result<Self::Output, Error>;
}