Struct me3_framework::scripting::lua::AnyUserData

pub struct AnyUserData<'lua>(_);

Handle to an internal Lua userdata for any type that implements UserData.

Similar to std::any::Any, this provides an interface for dynamic type checking via the is and borrow methods.

Internally, instances are stored in a RefCell, to best match the mutable semantics of the Lua language.

Note

This API should only be used when necessary. Implementing UserData already allows defining methods which check the type and acquire a borrow behind the scenes.

Implementations

impl<'lua> AnyUserData<'lua>

pub fn is<T>(&self) -> boolwhere
    T: 'static + UserData,

Checks whether the type of this userdata is T.

pub fn borrow<T>(&self) -> Result<Ref<'_, T>, Error>where
    T: 'static + UserData,

Borrow this userdata immutably if it is of type T.

Errors

Returns a UserDataBorrowError if the userdata is already mutably borrowed. Returns a UserDataTypeMismatch if the userdata is not of type T.

pub fn borrow_mut<T>(&self) -> Result<RefMut<'_, T>, Error>where
    T: 'static + UserData,

Borrow this userdata mutably if it is of type T.

Errors

Returns a UserDataBorrowMutError if the userdata cannot be mutably borrowed. Returns a UserDataTypeMismatch if the userdata is not of type T.

pub fn take<T>(&self) -> Result<T, Error>where
    T: 'static + UserData,

Takes out the value of UserData and sets the special “destructed” metatable that prevents any further operations with this userdata.

All associated user values will be also cleared.

pub fn set_user_value<V>(&self, v: V) -> Result<(), Error>where
    V: ToLua<'lua>,

Sets an associated value to this AnyUserData.

The value may be any Lua value whatsoever, and can be retrieved with get_user_value.

This is the same as calling set_nth_user_value with n set to 1.

pub fn get_user_value<V>(&self) -> Result<V, Error>where
    V: FromLua<'lua>,

Returns an associated value set by set_user_value.

This is the same as calling get_nth_user_value with n set to 1.

pub fn set_nth_user_value<V>(&self, n: usize, v: V) -> Result<(), Error>where
    V: ToLua<'lua>,

Sets an associated nth value to this AnyUserData.

The value may be any Lua value whatsoever, and can be retrieved with get_nth_user_value. n starts from 1 and can be up to 65535.

This is supported for all Lua versions. In Lua 5.4 first 7 elements are stored in a most efficient way. For other Lua versions this functionality is provided using a wrapping table.

pub fn get_nth_user_value<V>(&self, n: usize) -> Result<V, Error>where
    V: FromLua<'lua>,

Returns an associated nth value set by set_nth_user_value.

n starts from 1 and can be up to 65535.

This is supported for all Lua versions. In Lua 5.4 first 7 elements are stored in a most efficient way. For other Lua versions this functionality is provided using a wrapping table.

pub fn set_named_user_value<S, V>(&self, name: &S, v: V) -> Result<(), Error>where
    S: AsRef<[u8]> + ?Sized,
    V: ToLua<'lua>,

Sets an associated value to this AnyUserData by name.

The value can be retrieved with get_named_user_value.

pub fn get_named_user_value<S, V>(&self, name: &S) -> Result<V, Error>where
    S: AsRef<[u8]> + ?Sized,
    V: FromLua<'lua>,

Returns an associated value by name set by set_named_user_value.

pub fn get_metatable(&self) -> Result<UserDataMetatable<'lua>, Error>

Returns a metatable of this UserData.

Returned UserDataMetatable object wraps the original metatable and provides safe access to its methods.

For T: UserData + 'static returned metatable is shared among all instances of type T.

Trait Implementations

impl<'lua> AsRef<AnyUserData<'lua>> for AnyUserData<'lua>

fn as_ref(&self) -> &AnyUserData<'lua>

Converts this type into a shared reference of the (usually inferred) input type.

impl<'lua> Clone for AnyUserData<'lua>

fn clone(&self) -> AnyUserData<'lua>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'lua> Debug for AnyUserData<'lua>

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

Formats the value using the given formatter.

impl<'lua> FromLua<'lua> for AnyUserData<'lua>

fn from_lua(value: Value<'lua>, &'lua Lua) -> Result<AnyUserData<'lua>, Error>

Performs the conversion.

impl<'lua> PartialEq<AnyUserData<'lua>> for AnyUserData<'lua>

fn eq(&self, other: &AnyUserData<'lua>) -> bool

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

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

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

impl<'lua> Serialize for AnyUserData<'lua>

fn serialize<S>(
    &self,
    serializer: S
) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>where
    S: Serializer,

Serialize this value into the given Serde serializer.

impl<'lua> ToLua<'lua> for AnyUserData<'lua>

fn to_lua(self, &'lua Lua) -> Result<Value<'lua>, Error>

Performs the conversion.