Enum RestoreError 

#[non_exhaustive]
pub enum RestoreError {
    IdAlreadyLive(ItemId),
    MissingParent {
        id: ItemId,
        parent: ItemId,
    },
}

Why Scene::restore could not put a salvage back.

#[non_exhaustive]: this crate has out-of-tree consumers and the restore path may learn to refuse something new.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

IdAlreadyLive(ItemId)

An entry with this id is already in the scene. Restoring over it would alias two items onto one identity.

Defensive. Scene::take retires the id, so a second salvage for it cannot exist while the first is held, and the restore that succeeds consumes the one that does — which makes this unreachable through the public API today. It stays because it is the only thing standing between a future door that breaks that invariant and a corrupted entry_index, and refusing is better than aliasing.

MissingParent

The parent the item was removed from is not in the scene. Restore roots-first — Scene::restore_all orders a whole take result for you — or clear the recorded parent with RemovedItem::detach before restoring, which is what a move into a different scene normally wants.

The salvage is consumed by the refused call, so a caller that may hit this checks parent() (or calls detach()) before handing it over.

Fields

id: ItemId

The item that could not be restored.

parent: ItemId

The parent it names, which is absent.

Trait Implementations

impl Clone for RestoreError

fn clone(&self) -> RestoreError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RestoreError

impl Debug for RestoreError

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

Formats the value using the given formatter.

impl Display for RestoreError

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

Formats the value using the given formatter.

impl Eq for RestoreError

impl Error for RestoreError

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 PartialEq for RestoreError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RestoreError