Crate field_access

Source
Expand description

§field_access

Build Status crates.io docs.rs License: Apache 2.0 License: MIT

A library for dynamic access to struct fields with #![no_std] support.

Field access is enabled by the FieldAccess trait which can be implemented using a derive macro by the same name.

use field_access::FieldAccess;

#[derive(FieldAccess)]
struct Foo {
    a: u8
}

let mut foo = Foo { a: 1 };

// Immutable field access.
if let Some(field) = foo.field("a") {
    assert_eq!(field.as_u8(), Some(1));
}

// Mutable field access.
if let Some(mut field) = foo.field_mut("a") {
    assert_eq!(field.replace(42u8), Some(1));
}

assert_eq!(foo.a, 42);

§Cargo features

  • alloc: Provide methods to interact with types from the Rust core allocation and collections library including String and Vec<T>. This feature pulls in the alloc library as a dependency and is enabled by default.
  • derive: Provide a derive macro for the FieldAccess trait. This feature is enabled by default.

§License

The source code of field_access is licensed under either of Apache License, Version 2.0 or MIT license at your option.

Structs§

Field
An immutable struct field reference.
FieldMut
A mutable struct field reference.
Fields
An immutable iterator over all fields of a struct.

Traits§

AnyFieldAccess
Low-level struct field access.
FieldAccess
High-level struct field access.

Derive Macros§

FieldAccessderive
Derive macro for automatically implementing AnyFieldAccess on structs.