pub enum Entry<'w, 'a, T>where
T: Component,{
Occupied(OccupiedEntry<'w, 'a, T>),
Vacant(VacantEntry<'w, 'a, T>),
}
Expand description
A view into a single entity and component in a world, which may either be vacant or occupied.
This enum
can only be constructed from the entry
method on EntityWorldMut
.
Variants§
Occupied(OccupiedEntry<'w, 'a, T>)
An occupied entry.
Vacant(VacantEntry<'w, 'a, T>)
A vacant entry.
Implementations§
§impl<'w, 'a, T> Entry<'w, 'a, T>where
T: Component,
impl<'w, 'a, T> Entry<'w, 'a, T>where
T: Component,
pub fn and_modify<F>(self, f: F) -> Entry<'w, 'a, T>
pub fn and_modify<F>(self, f: F) -> Entry<'w, 'a, T>
Provides in-place mutable access to an occupied entry.
§Examples
#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);
let mut entity = world.spawn(Comp(0));
entity.entry::<Comp>().and_modify(|mut c| c.0 += 1);
assert_eq!(world.query::<&Comp>().single(&world).0, 1);
pub fn insert_entry(self, component: T) -> OccupiedEntry<'w, 'a, T>
pub fn insert_entry(self, component: T) -> OccupiedEntry<'w, 'a, T>
Replaces the component of the entry, and returns an OccupiedEntry
.
§Examples
#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);
let mut entity = world.spawn_empty();
let entry = entity.entry().insert_entry(Comp(4));
assert_eq!(entry.get(), &Comp(4));
let entry = entity.entry().insert_entry(Comp(2));
assert_eq!(entry.get(), &Comp(2));
pub fn or_insert(self, default: T) -> Mut<'a, T>
pub fn or_insert(self, default: T) -> Mut<'a, T>
Ensures the entry has this component by inserting the given default if empty, and returns a mutable reference to this component in the entry.
§Examples
#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);
let mut entity = world.spawn_empty();
entity.entry().or_insert(Comp(4));
assert_eq!(world.query::<&Comp>().single(&world).0, 4);
entity.entry().or_insert(Comp(15)).0 *= 2;
assert_eq!(world.query::<&Comp>().single(&world).0, 8);
pub fn or_insert_with<F>(self, default: F) -> Mut<'a, T>where
F: FnOnce() -> T,
pub fn or_insert_with<F>(self, default: F) -> Mut<'a, T>where
F: FnOnce() -> T,
Ensures the entry has this component by inserting the result of the default function if empty, and returns a mutable reference to this component in the entry.
§Examples
#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);
let mut entity = world.spawn_empty();
entity.entry().or_insert_with(|| Comp(4));
assert_eq!(world.query::<&Comp>().single(&world).0, 4);
§impl<'w, 'a, T> Entry<'w, 'a, T>
impl<'w, 'a, T> Entry<'w, 'a, T>
pub fn or_default(self) -> Mut<'a, T>
pub fn or_default(self) -> Mut<'a, T>
Ensures the entry has this component by inserting the default value if empty, and returns a mutable reference to this component in the entry.
§Examples
#[derive(Component, Default, Clone, Copy, Debug, PartialEq)]
struct Comp(u32);
let mut entity = world.spawn_empty();
entity.entry::<Comp>().or_default();
assert_eq!(world.query::<&Comp>().single(&world).0, 0);
Auto Trait Implementations§
impl<'w, 'a, T> Freeze for Entry<'w, 'a, T>
impl<'w, 'a, T> !RefUnwindSafe for Entry<'w, 'a, T>
impl<'w, 'a, T> Send for Entry<'w, 'a, T>
impl<'w, 'a, T> Sync for Entry<'w, 'a, T>
impl<'w, 'a, T> Unpin for Entry<'w, 'a, T>where
T: Unpin,
impl<'w, 'a, T> !UnwindSafe for Entry<'w, 'a, T>
Blanket Implementations§
§impl<T, U> AsBindGroupShaderType<U> for T
impl<T, U> AsBindGroupShaderType<U> for T
§fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
fn as_bind_group_shader_type(&self, _images: &RenderAssets<GpuImage>) -> U
T
ShaderType
for self
. When used in AsBindGroup
derives, it is safe to assume that all images in self
exist.source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
.§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
.§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
&Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s.§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
&mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s.§impl<T> DowncastSync for T
impl<T> DowncastSync for T
§impl<S> FromSample<S> for S
impl<S> FromSample<S> for S
fn from_sample_(s: S) -> S
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left
is true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self
into a Left
variant of Either<Self, Self>
if into_left(&self)
returns true
.
Converts self
into a Right
variant of Either<Self, Self>
otherwise. Read more