Struct ReplaceRejected 

#[non_exhaustive]
pub struct ReplaceRejected {
    pub error: ReplaceItemError,
    pub item: Box<dyn SceneItem>,
}

A refused Scene::replace_item: why, and the item it did not take.

The item comes back rather than being dropped, because a refused write must not eat the caller’s value. A Box<dyn SceneItem> can be expensive to build and cannot be cloned, so a caller recovering from a precondition violation would otherwise have nothing left to insert instead — and the row it was reconciling would silently vanish.

#[non_exhaustive]: see RestoreError. The crate only ever hands this out, so there is nothing to construct — recover the item with let ReplaceRejected { item, .. } = rejected;.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

error: ReplaceItemError

Why the write was refused.

item: Box<dyn SceneItem>

The item that was not inserted, handed straight back.

Trait Implementations

impl Debug for ReplaceRejected

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

Formats the value using the given formatter.

impl Display for ReplaceRejected

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

Formats the value using the given formatter.

impl Error for ReplaceRejected

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.