Enum WorldError

pub enum WorldError {
    Archetype(ArchetypeError),
    ReachedEntityIdCapacity,
    ReachedArchetypeIdCapacity,
    EntityDoesNotExists {
        entity: Entity,
    },
    ArchetypeDoesNotExists {
        id: u32,
    },
    DuplicateMutableArchetypeAccess {
        id: u32,
    },
    EmptyColumnSet,
}

Represents errors that can occur in the ECS World.

Variants

Archetype(ArchetypeError)

Error related to an archetype operation.

ReachedEntityIdCapacity

Indicates that the system has reached the maximum capacity for entity IDs.

ReachedArchetypeIdCapacity

Indicates that the system has reached the maximum capacity for archetype IDs.

EntityDoesNotExists

Indicates that an operation was attempted on an entity that does not exist.

Fields

entity: Entity

ArchetypeDoesNotExists

Indicates that an operation was attempted on an archetype that does not exist.

Fields

id: u32

DuplicateMutableArchetypeAccess

Indicates an attempt to access the same archetype mutably more than once, which could lead to data race issues.

Fields

id: u32

EmptyColumnSet

Indicates that an operation involved an empty column set, which is invalid in the ECS context.

Implementations

impl WorldError

pub fn allow<T>( input: Result<T, Self>, items: impl IntoIterator<Item = Self>, ok: T, ) -> Result<T, Self>

Allows certain errors to be ignored by providing a fallback value (ok).

This method checks whether the error matches any of the allowed error variants provided in items. If a match is found, the provided fallback value (ok) is returned instead. Otherwise, the original error is returned.

Arguments

• input - A Result that may contain an error to evaluate.
• items - A collection of WorldError variants to allow.
• ok - The value to return if the error matches one of the allowed variants.

Returns

• Ok(ok) if the error matches an allowed variant.
• Err(error) if the error does not match any allowed variant.

Trait Implementations

impl Debug for WorldError

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

Formats the value using the given formatter.

impl Display for WorldError

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

Formats the value using the given formatter.

impl Error for WorldError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ArchetypeError> for WorldError

fn from(value: ArchetypeError) -> Self

Converts to this type from the input type.

impl From<WorldError> for PrefabError

fn from(value: WorldError) -> Self

Converts to this type from the input type.

impl PartialEq for WorldError

fn eq(&self, other: &WorldError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for WorldError

impl StructuralPartialEq for WorldError