function::user_string_nofault - Linux


The function::user_string_nofault command allows Rust functions to be exposed to the C API while ensuring that the Rust function panics are not propagated to the C caller.


function::user_string_nofault<F, R, E>(name: &str, f: F, docs: Option<&str>) -> Result<*const glib::ffi::GFn, glib::Error>


| Argument | Description |
| name | The name of the function to be exposed |
| f | The Rust function to be exposed |
| docs | Optional documentation string for the function |


| Flag | Description |
| docs | Specifies the documentation string for the function. |


use function::{func, user_string_nofault};

function::cfuncs! {
    pub fn add_two(a: i32, b: i32) -> i32 {
        a + b

fn main() {
    let add_two = user_string_nofault("add_two", add_two, Some("Adds two numbers")).unwrap();
    println!("add_two: {:?}", unsafe { add_two(1, 2) });

Common Issues

  • Ensure that the Rust function’s signature matches the C signature expected by the caller.
  • Check that the C caller is not expecting any exceptions from the Rust function, as user_string_nofault suppresses panics.


function::user_string_nofault can be used to create CFFI (C Foreign Function Interface) bindings for Rust functions, making it possible to expose Rust functions to C and other languages.

Related Commands