#fields #iterator #struct-fields #field

no-std fields-iter

A crate that allows you inspecting the fields of structs

3 releases

0.0.3 Nov 24, 2022
0.0.2 Nov 24, 2022
0.0.1 Nov 24, 2022

#259 in No standard library

29 downloads per month

MIT license

17KB
184 lines

fields-iter

A crate that allows iterating over over struct's fields, getting their name and a mutable/shared reference to them.

Examples

Printing the values of all field whose name starts with "a" and are strings:

use fields_iter::{FieldsInspect, FieldsIter};

fn print_starts_with_a(v: &dyn FieldsInspect) {
    for (name, value) in FieldsIter::new(v) {
        if !name.starts_with('a') { continue };
        let Some(value) = value.downcast_ref::<String>() else { continue };
        println!("{name}={value}");
    }
}

Adding one to the field add_here:

use fields_iter::{FieldsInspect, FieldsIterMut};

let v: &mut dyn FieldsInspect;
let field = FieldsIterMut::new(v)
    .find(|&(name, _)| name == "add_here")
    .expect("no `add_here` field")
    .1
    .downcast_mut::<i32>()
    .expect("field `add_here` is not of type `i32`");
*field += 1;
# assert_eq!(original.add_here, 1);

lib.rs:

A crate macro that allows you inspecting the fields of structs.

See the docs on FieldsInspect for more.

no-std support

This crate is no-std compatible.

Dependencies

~1.5MB
~33K SLoC