A macro generating correct opaque types.
Until RFC 1861 (Extern types) is implemented, representing opaque structs in Rust is hard, as decribed in the corresponding Nomicon section.
Yet, opaque structs are a common pattern, especially when working with C codebases through FFI.
ffi-opaque provides the opaque! macro which properly generates such types without having to think about the details.
Types generated by this macro are:
* are zero-sized
* cannot be constructed outside of the module they are defined in
* have proper alignment
* are !Send, !Sync, !Unpin
* are FFI safe
Consider this example from the leveldb C API:
```c typedef struct leveldboptionst leveldboptionst; typedef struct leveldbwriteoptionst leveldbwriteoptionst;
leveldboptionst* leveldboptionscreate(); leveldbwriteoptionst* leveldbwriteoptionscreate(); ```
It uses an opaque struct to avoid leaking structural details of its database options to a library linking to it. We can represent the opaque structs on the Rust side like this:
```rust use ffi_opaque::opaque;
opaque! { /// Documentation works! pub struct leveldboptionst; /// Options used when writing data pub struct leveldbwriteoptionst; }
extern "C" { pub fn leveldboptionscreate() -> *mut leveldboptionst; pub fn leveldbwriteoptionscreate() -> *mut leveldbwriteoptionst; } ```
If extern types become stabilised, this macro may adopt them.
MIT, see LICENSE file.