Enum gdnative::nativescript::user_data::DeadlockPolicy

pub enum DeadlockPolicy {
    Allow,
    Pessimistic,
    Timeout(Duration),
}

Policies to deal with potential deadlocks

As Godot allows mutable pointer aliasing, doing certain things in exported method bodies may lead to the engine calling another method on owner, leading to another locking attempt within the same thread:

• Variant calls on anything may dispatch to a script method.
• Anything that could emit signals, that are connected to in a non-deferred manner.

As there is no universal way to deal with such situations, behavior of locking wrappers can be customized using this enum.

Variants

Allow

Block on all locks. Deadlocks are possible.

Pessimistic

Never block on any locks. Methods will return Nil immediately if the lock isn't available. Deadlocks are prevented.

Timeout(Duration)

Block on locks for at most Duration. Methods return Nil on timeout. Deadlocks are prevented.

Trait Implementations

impl Clone for DeadlockPolicy

pub fn clone(&self) -> DeadlockPolicy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for DeadlockPolicy

impl Debug for DeadlockPolicy

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

Formats the value using the given formatter.

impl Eq for DeadlockPolicy

impl Hash for DeadlockPolicy

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for DeadlockPolicy

pub fn cmp(&self, other: &DeadlockPolicy) -> Ordering

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<DeadlockPolicy> for DeadlockPolicy

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<DeadlockPolicy> for DeadlockPolicy

pub fn partial_cmp(&self, other: &DeadlockPolicy) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

pub fn lt(&self, other: &DeadlockPolicy) -> bool

This method tests less than (for self and other) and is used by the < operator.

pub fn le(&self, other: &DeadlockPolicy) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

pub fn gt(&self, other: &DeadlockPolicy) -> bool

This method tests greater than (for self and other) and is used by the > operator.

pub fn ge(&self, other: &DeadlockPolicy) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralEq for DeadlockPolicy

impl StructuralPartialEq for DeadlockPolicy