#field #compile-time #macro-derive #getter #type

get-field-by-type

Get a value of field, based on the type of a field

3 releases

0.0.4 Mar 1, 2024
0.0.3 Sep 15, 2023
0.0.2 Jun 27, 2023

#1853 in Rust patterns

Download history 15/week @ 2024-07-29 28/week @ 2024-08-05 15/week @ 2024-08-12 10/week @ 2024-08-19 42/week @ 2024-08-26 6/week @ 2024-09-02 12/week @ 2024-09-09 3/week @ 2024-09-16 35/week @ 2024-09-23 6/week @ 2024-09-30 2/week @ 2024-10-07 13/week @ 2024-10-14 4/week @ 2024-10-21 6/week @ 2024-10-28 25/week @ 2024-11-04 19/week @ 2024-11-11

56 downloads per month
Used in 4 crates (via ezno-parser)

MIT license

6KB

Get-field-by-type

crates.io badge docs.rs badge

Create a getter for a field based on its type. For example

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
enum Enum1 {
	A(i32, char),
	B(i32, bool),
	C(i32, String)
}

let x = Enum1::A(12, '!');
assert_eq!(*GetFieldByType::<i32>::get(&x), 12);

Why not impl &Self for Into<&T>

Using Into on references for getting a field is a bit of hack. This is designed for getting the value for a field with a common type. Using a custom trait also means flexibility in the future

Additional options and features

When a struct of variant doesn't have a type, there are two behaviors

Either a compile time error (default)

Or a specified statement to evaluate. This could be a panic

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
#[get_field_no_type_behavior(panic!("could not find item");)]
enum Enum2 {
	A(i32),
	B(i32),
	C
}

assert_eq!(*GetFieldByType::<i32>::get(&Enum2::A(12)), 12);

let result = std::panic::catch_unwind(|| {
	let _value = *GetFieldByType::<i32>::get(&Enum2::C);
});
assert!(result.is_err());

or returning a constant value

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
#[get_field_no_type_behavior(return &0;)]
enum Enum2 {
	A(i32),
	B(i32),
	C
}

assert_eq!(*GetFieldByType::<i32>::get(&Enum2::A(12)), 12);
assert_eq!(*GetFieldByType::<i32>::get(&Enum2::C), 0);

Recursive on unit variants

In the AOrB enum case, the derive macro can't find a i32 on variant AOrB::A. However, as it is a unit variant, the implementation delegates it to the unit type.

use get_field_by_type::GetFieldByType;

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
struct A(pub i32);

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
struct B(pub i32);

#[derive(GetFieldByType)]
#[get_field_by_type_target(i32)]
enum AOrB {
	A(A),
	B(B)
}

let b = B(10);
assert_eq!(*GetFieldByType::<i32>::get(&b), 10);

let a_or_b = AOrB::B(b);
assert_eq!(*GetFieldByType::<i32>::get(&a_or_b), 10);

Alternatives

For more manual field access, check out getset. If looking for getting multiple fields, check out getters-by-type

Dependencies

~265–700KB
~17K SLoC