{"id":15136244,"url":"https://github.com/aandreba/ffi-closure","last_synced_at":"2025-10-30T17:39:31.923Z","repository":{"id":224243550,"uuid":"762796928","full_name":"Aandreba/ffi-closure","owner":"Aandreba","description":"Send and recevie closures through FFI","archived":false,"fork":false,"pushed_at":"2024-05-12T10:50:54.000Z","size":20,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-30T18:05:16.764Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Aandreba.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null},"funding":{"github":["Aandreba"]}},"created_at":"2024-02-24T18:04:35.000Z","updated_at":"2024-08-12T19:22:48.000Z","dependencies_parsed_at":"2024-02-24T19:31:07.732Z","dependency_job_id":"093386bc-d2c0-44e3-8213-2ebb46c08599","html_url":"https://github.com/Aandreba/ffi-closure","commit_stats":null,"previous_names":["aandreba/ffi-closure"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aandreba%2Fffi-closure","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aandreba%2Fffi-closure/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aandreba%2Fffi-closure/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aandreba%2Fffi-closure/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aandreba","download_url":"https://codeload.github.com/Aandreba/ffi-closure/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237821514,"owners_count":19371775,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-26T06:04:40.636Z","updated_at":"2025-10-23T11:31:23.176Z","avatar_url":"https://github.com/Aandreba.png","language":"Rust","funding_links":["https://github.com/sponsors/Aandreba"],"categories":[],"sub_categories":[],"readme":"# ffi-closure - Send and Receive closures through FFI\n\n[![Crates.io Version](https://img.shields.io/crates/v/ffi-closure)\n](https://crates.io/crates/ffi-closure)\n[![docs.rs](https://img.shields.io/docsrs/ffi-closure)](https://docs.rs/ffi-closure/)\n\n## Features\n\n- Simple to use API\n- Allows sending Rust functions \u0026 closures through FFI boundary\n- `no-std` compatible\n- Supports multiple calling conventions (defaults to C calling convention)\n- Simplifies usage and interaction with FFI _closure-like_ functions\n- Closures can have destructors\n- Can specify closure's thread-safety level (None, `Send`, `Sync` or `Send + Sync`)\n\n## Examples\n\n**Export closure**\n\n```rust\nuse ffi_closure::Closure;\nuse std::ffi::c_void;\n# mod sys {\n#     use core::ffi::c_void;\n#     #[no_mangle]\n#     unsafe extern \"C\" fn some_lib_fn(f: unsafe extern \"C\" fn(i8, *mut c_void), user_data: *mut c_void) { f(-1, user_data) }\n# }\n\nextern \"C\" {\n    fn some_lib_fn(f: unsafe extern \"C\" fn(i8, *mut c_void), user_data: *mut c_void);\n}\n\npub fn main() {\n    let weight = std::env::args().len() as i8;\n    let closure = Closure::\u003cdyn FnMut(i8)\u003e::new(move |x| println!(\"{}\", x * weight));\n\n    let (f, user_data): (unsafe extern \"C\" fn(i8, *mut c_void), *mut c_void) = closure.as_extern_parts();\n    unsafe {\n        some_lib_fn(f, user_data);\n    }\n}\n\n```\n\n**Exported closure w/ system calling convention**\n\n```rust\nuse ffi_closure::{Closure, cc::System};\nuse std::ffi::c_void;\n# mod sys {\n#     use core::ffi::c_void;\n#     #[no_mangle]\n#     unsafe extern \"C\" fn some_lib_fn(f: unsafe extern \"C\" fn(i8, *mut c_void), user_data: *mut c_void) { f(-1, user_data) }\n# }\n\nextern \"C\" {\n    fn some_lib_fn(f: unsafe extern \"system\" fn(i8, *mut c_void), user_data: *mut c_void);\n}\n\npub fn main() {\n    let weight = std::env::args().len() as i8;\n    let closure = Closure::\u003cdyn FnMut(i8), System\u003e::new(move |x| println!(\"{}\", x * weight));\n\n    let (f, user_data): (unsafe extern \"system\" fn(i8, *mut c_void), *mut c_void) = closure.as_extern_parts();\n    unsafe {\n        some_lib_fn(f, user_data);\n    }\n}\n```\n\n**Imported closure**\n\n```rust\nuse ffi_closure::Closure;\nuse std::ffi::c_void;\n\n#[no_mangle]\npub extern \"C\" fn some_lib_fn(\n    f: unsafe extern \"C\" fn(i8, *mut c_void),\n    user_data: *mut c_void,\n) {\n    let mut f = unsafe { Closure::\u003cdyn FnMut(i8)\u003e::from_extern(f, user_data, None) };\n    for i in 0..10 {\n        f(i);\n    }\n}\n\n```\n\n**Imported, thread-safe closure**\n\n```rust\nuse ffi_closure::{Closure};\nuse std::ffi::c_void;\n\n#[no_mangle]\npub unsafe extern \"C\" fn some_lib_fn(\n    f: unsafe extern \"C\" fn(i8, *mut c_void),\n    user_data: *mut c_void,\n) {\n    // SAFETY: Caller must ensure the passed function pointer and user data are thread-safe.\n    let mut f = unsafe { Closure::\u003cdyn Send + FnMut(i8)\u003e::from_extern(f, user_data, None) };\n\n    std::thread::spawn(move || {\n        for i in 0..10 {\n            f(i);\n        }\n    });\n}\n\n```\n\n\u003e **Note**\\\n\u003e For `Closure` to implement `FnOnce` and `FnMut`, the 'nightly' feature must be enabled (and thus, the program must be built with nightly Rust).\n\u003e For a non-nightly version, use `Closure::call`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faandreba%2Fffi-closure","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faandreba%2Fffi-closure","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faandreba%2Fffi-closure/lists"}