Struct NonSend

pub struct NonSend<'w, T: 'static> { /* private fields */ }

Shared borrow of a non-Send resource.

Only Send resources may be accessed with the Res SystemParam. In case that the resource does not implement Send, this SystemParam wrapper can be used. This will instruct the scheduler to instead run the system on the main thread so that it doesn’t send the resource over to another thread.

This SystemParam fails validation if non-send resource doesn’t exist. This will cause a panic, but can be configured to do nothing or warn once.

Use Option<NonSend<T>> instead if the resource might not always exist.

Implementations

impl<'w, T: 'static> NonSend<'w, T>

pub fn is_added(&self) -> bool

Returns true if the resource was added after the system last ran.

pub fn is_changed(&self) -> bool

Returns true if the resource was added or mutably dereferenced after the system last ran.

pub fn changed_by(&self) -> MaybeLocation

The location that last caused this to change.

Trait Implementations

impl<'w, T> Debug for NonSend<'w, T>

where T: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'w, T> Deref for NonSend<'w, T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<'a, T> From<NonSendMut<'a, T>> for NonSend<'a, T>

fn from(nsm: NonSendMut<'a, T>) -> Self

Converts to this type from the input type.

impl<'a, T: 'static> SystemParam for NonSend<'a, T>

type State = ComponentId

Used to store data which persists across invocations of a system.

type Item<'w, 's> = NonSend<'w, T>

The item type returned when constructing this system param. The value of this associated type should be Self, instantiated with new lifetimes.

fn init_state(world: &mut World, system_meta: &mut SystemMeta) -> Self::State

Registers any World access used by this SystemParam and creates a new instance of this param’s State.

unsafe fn validate_param( component_id: &Self::State, _system_meta: &SystemMeta, world: UnsafeWorldCell<'_>, ) -> Result<(), SystemParamValidationError>

Validates that the param can be acquired by the get_param.

unsafe fn get_param<'w, 's>( component_id: &'s mut Self::State, system_meta: &SystemMeta, world: UnsafeWorldCell<'w>, change_tick: Tick, ) -> Self::Item<'w, 's>

Creates a parameter to be passed into a SystemParamFunction.

unsafe fn new_archetype( state: &mut Self::State, archetype: &Archetype, system_meta: &mut SystemMeta, )

For the specified Archetype, registers the components accessed by this SystemParam (if applicable).a

fn apply(state: &mut Self::State, system_meta: &SystemMeta, world: &mut World)

Applies any deferred mutations stored in this SystemParam’s state. This is used to apply Commands during ApplyDeferred.

fn queue( state: &mut Self::State, system_meta: &SystemMeta, world: DeferredWorld<'_>, )

Queues any deferred mutations to be applied at the next ApplyDeferred.

impl<'w, T> ReadOnlySystemParam for NonSend<'w, T>