pub trait Struct: PartialReflect {
// Required methods
fn field(&self, name: &str) -> Option<&dyn PartialReflect>;
fn field_mut(&mut self, name: &str) -> Option<&mut dyn PartialReflect>;
fn field_at(&self, index: usize) -> Option<&dyn PartialReflect>;
fn field_at_mut(&mut self, index: usize) -> Option<&mut dyn PartialReflect>;
fn name_at(&self, index: usize) -> Option<&str>;
fn index_of_name(&self, name: &str) -> Option<usize>;
fn field_len(&self) -> usize;
fn iter_fields(&self) -> FieldIter<'_> ⓘ;
// Provided methods
fn to_dynamic_struct(&self) -> DynamicStruct { ... }
fn get_represented_struct_info(&self) -> Option<&'static StructInfo> { ... }
}Expand description
A trait used to power struct-like operations via reflection.
This trait uses the Reflect trait to allow implementors to have their fields
be dynamically addressed by both name and index.
When using #[derive(Reflect)] on a standard struct,
this trait will be automatically implemented.
This goes for unit structs as well.
§Example
use bevy_reflect::{PartialReflect, Reflect, structs::Struct};
#[derive(Reflect)]
struct Foo {
bar: u32,
}
let foo = Foo { bar: 123 };
assert_eq!(foo.field_len(), 1);
assert_eq!(foo.name_at(0), Some("bar"));
let field: &dyn PartialReflect = foo.field("bar").unwrap();
assert_eq!(field.try_downcast_ref::<u32>(), Some(&123));Required Methods§
Sourcefn field(&self, name: &str) -> Option<&dyn PartialReflect>
fn field(&self, name: &str) -> Option<&dyn PartialReflect>
Gets a reference to the value of the field named name as a &dyn PartialReflect.
Sourcefn field_mut(&mut self, name: &str) -> Option<&mut dyn PartialReflect>
fn field_mut(&mut self, name: &str) -> Option<&mut dyn PartialReflect>
Gets a mutable reference to the value of the field named name as a
&mut dyn PartialReflect.
Sourcefn field_at(&self, index: usize) -> Option<&dyn PartialReflect>
fn field_at(&self, index: usize) -> Option<&dyn PartialReflect>
Gets a reference to the value of the field with index index as a
&dyn PartialReflect.
Sourcefn field_at_mut(&mut self, index: usize) -> Option<&mut dyn PartialReflect>
fn field_at_mut(&mut self, index: usize) -> Option<&mut dyn PartialReflect>
Gets a mutable reference to the value of the field with index index
as a &mut dyn PartialReflect.
Sourcefn index_of_name(&self, name: &str) -> Option<usize>
fn index_of_name(&self, name: &str) -> Option<usize>
Gets the index of the field with the given name.
Sourcefn iter_fields(&self) -> FieldIter<'_> ⓘ
fn iter_fields(&self) -> FieldIter<'_> ⓘ
Returns an iterator over the values of the reflectable fields for this struct.
Provided Methods§
Sourcefn to_dynamic_struct(&self) -> DynamicStruct
fn to_dynamic_struct(&self) -> DynamicStruct
Creates a new DynamicStruct from this struct.
Sourcefn get_represented_struct_info(&self) -> Option<&'static StructInfo>
fn get_represented_struct_info(&self) -> Option<&'static StructInfo>
Will return None if TypeInfo is not available.
Trait Implementations§
Dyn Compatibility§
This trait is dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety".