11 releases

new 0.0.13 Nov 4, 2024
0.0.12 Jul 30, 2024
0.0.9 Jun 19, 2024
0.0.7 May 13, 2024
0.0.4 Jan 12, 2024

#92 in FFI

Download history 2/week @ 2024-07-14 602/week @ 2024-07-28 113/week @ 2024-08-04 13/week @ 2024-08-11 1/week @ 2024-08-18 97/week @ 2024-09-01 4/week @ 2024-09-08 87/week @ 2024-09-15 213/week @ 2024-09-22 23/week @ 2024-09-29 2/week @ 2024-10-06 25/week @ 2024-10-13 15/week @ 2024-10-20 30/week @ 2024-10-27

73 downloads per month

BSD-2-Clause

31KB
809 lines

ffi_types

This repository provides C-ABI compatible basic Rust types including box, slice, str and boxed slice/str. By carefully following instructions, the types are bindgen/cbindgen compatible and owned values are safe under C++.

The project consists of 2 parts. A rust crate of #[repr(C)] wrappers of rust types and a header file for C++ (or a few more later).

The conversions are intended to be zero-cost.

TODO: link to docs and examples

CBindgen

Use ffi_types::cbindgen::with_cxx_ffi_types() to add proper configuration to cbindgen::Builder.

Bindgen

Block the provided header to blocklist_file. Replace all root::ffi_types:: to ffi_types:: in generated file.

Not the best choice for FFI

If you start a new project, please check cxx fits in your case.

Since the goal of ffi_types is exposing Rust type to C++ side, you need access to C++ code base.

ffi_types only provides types. Nothing is automatic. You still need to manage bindgen/cbindgen.

MSVC is very picky. ffi_types limits convenience initializers for C-prefixed types for MSVC. It will be less convenient and more unsafe.

Dependencies

~0–8.5MB
~88K SLoC