qemu-api/src/callbacks.rs

8 /// callbacks. These include both zero-capture closures and function pointers.
10 /// In Rust, calling a function through the `Fn` trait normally requires a
11 /// `self` parameter, even though for zero-sized functions (including function
13 /// function. This trait provides a `call` function that doesn't require `self`,
17 /// parameters and resolved at compile-time. A typical use is a function
19 /// `F::call` or passing it to another function via `func::<F>`.
28 /// // The compiler creates a new `rust_bh_cb` wrapper for each function
48 /// compiled to a separate function ("monomorphization").  If you wanted
52 /// `Args` is a tuple type whose types are the arguments of the function,
68 /// each function that is passed to it.  Therefore the argument is not really
82 /// `()` can be used to indicate "no function":
113 /// This is always true for zero-capture closures and function pointers, as long
114 /// as the code is able to name the function in the first place.
122     /// function type, which can be used to catch incorrect use of `()`
141     /// `true` if `Self` is an actual function type and not `()`.
158     /// `false` if `Self` is an actual function type, `true` if it is `()`.
163     /// `true` if `Self` is an actual function type, `false` if it is `()`.
168     /// Call the function with the arguments in args.
172 /// `()` acts as a "null" callback.  Using `()` and `function` is nicer
173 /// than `None` and `Some(function)`, because the compiler is unable to
179     /// Call the function with the arguments in args.
187         // SAFETY: because each function is treated as a separate type,
189         // allowed to call the function.