Struct apecs::Write

pub struct Write<T: IsResource, G: Gen<T> = SomeDefault>(_, _);

A mutably borrowed resource that may be created by default.

Read and Write are the main way systems interact with resources. When fetched the wrapped type T will automatically be created by default. If fetched as Write<T, NoDefault> the fetch will err if the resource doesn’t already exist.

After a successful fetch, the resource will be automatically sent back to the world on drop. To make sure that your async functions don’t hold fetched resources over await points, Facade uses visit which fetches inside a syncronous closure.

Write has two type parameters:

• T - The type of the resource.
• G - The method by which the resource can be generated if it doesn’t already exist. By default this is SomeDefault, which denotes creating the resource using its default implementation. Another option is NoDefault which fails to generate the resource.

use apecs::*;

let mut world = World::default();
{
    let default_number = world.fetch::<Read<u32>>();
    assert_eq!(Some(0), default_number.map(|n| *n).ok());
}
{
    let no_number = world.fetch::<Read<f32, NoDefault>>();
    assert!(no_number.is_err());
}

Implementations

impl<T: IsResource, G: Gen<T>> Write<T, G>

pub fn inner(&self) -> &T

An explicit method of getting a reference to the inner type without Deref.

pub fn inner_mut(&mut self) -> &mut T

An explicit method of getting a mutable reference to the inner type without DerefMut.

Trait Implementations

impl<'a, T: IsResource, G: Gen<T> + IsResource> CanFetch for Write<T, G>

fn borrows() -> Vec<Borrow>

fn construct(loan_mngr: &mut LoanManager<'_>) -> Result<Self>

Attempt to construct Self with the given LoanManager.

fn plugin() -> Plugin

Return a plugin containing the systems and sub-resources required to create and use the type.

impl<T: IsResource, G: Gen<T>> Deref for Write<T, G>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T: IsResource, G: Gen<T>> DerefMut for Write<T, G>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'a, T: Send + Sync + 'static, G: Gen<T>> IntoIterator for &'a Write<T, G>where
    &'a T: IntoIterator,

type Item = <<&'a T as IntoIterator>::IntoIter as Iterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'a T as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: Send + Sync + 'static, G: Gen<T>> IntoIterator for &'a mut Write<T, G>where
    &'a mut T: IntoIterator,

type Item = <<&'a mut T as IntoIterator>::IntoIter as Iterator>::Item

The type of the elements being iterated over.

type IntoIter = <&'a mut T as IntoIterator>::IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<'a, T: Send + Sync + 'static, G: Gen<T>> IntoParallelIterator for &'a Write<T, G>where
    &'a T: IntoParallelIterator,

type Item = <&'a T as IntoParallelIterator>::Item

The type of item that the parallel iterator will produce.

type Iter = <&'a T as IntoParallelIterator>::Iter

The parallel iterator type that will be created.

fn into_par_iter(self) -> Self::Iter

Converts self into a parallel iterator.

impl<'a, T: Send + Sync + 'static, G: Gen<T>> IntoParallelIterator for &'a mut Write<T, G>where
    &'a mut T: IntoParallelIterator,

type Item = <&'a mut T as IntoParallelIterator>::Item

The type of item that the parallel iterator will produce.

type Iter = <&'a mut T as IntoParallelIterator>::Iter

The parallel iterator type that will be created.

fn into_par_iter(self) -> Self::Iter

Converts self into a parallel iterator.