bevy_reflect 0.18.1

Dynamically interact with rust types
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

/// Helper macro to implement the necessary traits for function reflection.
///
/// This macro calls the following macros:
/// - [`impl_get_ownership`](crate::func::args::impl_get_ownership)
/// - [`impl_from_arg`](crate::func::args::impl_from_arg)
/// - [`impl_into_return`](crate::func::impl_into_return)
///
/// # Syntax
///
/// For non-generic types, the macro simply expects the type:
///
/// ```ignore
/// impl_function_traits!(foo::bar::Baz);
/// ```
///
/// For generic types, however, the generic type parameters must also be given in angle brackets (`<` and `>`):
///
/// ```ignore
/// impl_function_traits!(foo::bar::Baz<T, U>; <T: Clone, U>);
/// ```
///
/// For generic const parameters, they must be given in square brackets (`[` and `]`):
///
/// ```ignore
/// impl_function_traits!(foo::bar::Baz<T, N>; <T> [const N: usize]);
/// ```
macro_rules! impl_function_traits {
    (
        $ty: ty
        $(;
            < $($T: ident $(: $T1: tt $(+ $T2: tt)*)?),* >
        )?
        $(
            [ $(const $N: ident : $size: ident),* ]
        )?
        $(
            where $($U: ty $(: $U1: tt $(+ $U2: tt)*)?),*
        )?
    ) => {
        $crate::func::args::impl_get_ownership!(
            $ty
            $(;
                < $($T $(: $T1 $(+ $T2)*)?),* >
            )?
            $(
                [ $(const $N : $size),* ]
            )?
            $(
                where $($U $(: $U1 $(+ $U2)*)?),*
            )?
        );
        $crate::func::args::impl_from_arg!(
            $ty
            $(;
                < $($T $(: $T1 $(+ $T2)*)?),* >
            )?
            $(
                [ $(const $N : $size),* ]
            )?
            $(
                where $($U $(: $U1 $(+ $U2)*)?),*
            )?
        );
        $crate::func::impl_into_return!(
            $ty
            $(;
                < $($T $(: $T1 $(+ $T2)*)?),* >
            )?
            $(
                [ $(const $N : $size),* ]
            )?
            $(
                where $($U $(: $U1 $(+ $U2)*)?),*
            )?
        );
    };
}

pub(crate) use impl_function_traits;

/// Helper macro that returns the number of tokens it receives.
///
/// See [here] for details.
///
/// [here]: https://veykril.github.io/tlborm/decl-macros/building-blocks/counting.html#bit-twiddling
macro_rules! count_tokens {
    () => { 0 };
    ($odd:tt $($a:tt $b:tt)*) => { ($crate::func::macros::count_tokens!($($a)*) << 1) | 1 };
    ($($a:tt $even:tt)*) => { $crate::func::macros::count_tokens!($($a)*) << 1 };
}

pub(crate) use count_tokens;