#attributes #function #macro #conditional-compilation #argument #proc #specify

macro fn_has_this

A proc attribute macro that allows you to specify whether a function has a this argument (for conditional compilation)

1 unstable release

0.1.1 Sep 26, 2021
0.1.0 Sep 26, 2021

#22 in #specify

Download history 32/week @ 2024-07-29 20/week @ 2024-08-05 23/week @ 2024-08-12 10/week @ 2024-08-19 22/week @ 2024-08-26 23/week @ 2024-09-02 28/week @ 2024-09-09 24/week @ 2024-09-16 48/week @ 2024-09-23 29/week @ 2024-09-30 1/week @ 2024-10-07 23/week @ 2024-10-14 13/week @ 2024-10-21 50/week @ 2024-10-28 25/week @ 2024-11-04 6/week @ 2024-11-11

96 downloads per month
Used in 2 crates (via gmod)

MIT license

6KB
80 lines

crates.io

fn_has_this

A proc attribute macro that adds a this argument to a function.

This macro is well suited for conditional compilation. For example, some compilers will optimize away a this argument in a non-static function if it is unused, sometimes depending on calling convention. This macro makes it easy to conditionally compile your Rust programs to interact over FFI with functions compiled in this way.

Example

#[macro_use]
extern crate fn_has_this;

use core::ffi::c_void;

#[has_this("*mut c_void")] // Will create an argument called `this` in the function
pub unsafe extern "fastcall" fn print_pointer() {
    println!("{:x?}", this);
}

#[has_this("me: *mut c_void")] // You can also specify a custom name for the `this` argument
pub unsafe extern "thiscall" fn print_pointer() {
    println!("{:x?}", me);
}

#[cfg_attr(target_os = "windows", has_this("me: *mut c_void"))] // Using `cfg_attr`, you can conditionally compile this attribute macro
pub unsafe extern "thiscall" fn print_pointer() {
    println!("{:x?}", me);
}

Dependencies

~1.5MB
~38K SLoC