Struct glsp::RData

pub struct RData { /* fields omitted */ }

The rdata primitive type.

This is a Rust value which has been moved onto the garbage-collected heap. It can be constructed using the glsp::rdata function.

RData has several convenience features:

• It supports interior mutability, like a RefCell.

• It can be manually deallocated, or taken back from the garbage-collected heap, using free and take. Any attempts to access a deallocated RData from GameLisp will trigger an error.

• It's dynamically typed: a Vec<Root<RData>> could refer to several different Rust types. (If this is undesirable, consider using RRoot instead.)

• The rdata! macro enables Rust functions to be associated with an RData as its methods and properties. They can be accessed from GameLisp code, or accessed from Rust code using an API similar to Obj.

Implementations

impl RData

pub fn type_name(&self) -> &'static str

pub fn class_name(&self) -> Sym

pub fn is<T>(&self) -> bool where
    T: RStore, 

Returns true if this RData is currently storing a value of type T.

pub fn borrow<T>(&self) -> RRef<T> where
    T: RStore, 

Returns a shared reference to the value being stored by this RData.

Panics if the RData is not storing a value of type T; if its value has been freed; or if the value is currently mutably borrowed.

pub fn try_borrow<T>(&self) -> Result<RRef<T>, GError> where
    T: RStore, 

Returns a shared reference to the value being stored by this RData.

Returns an Err if the RData is not storing a value of type T; if its value has been freed; or if the value is currently mutably borrowed.

pub fn borrow_mut<T>(&self) -> RRefMut<T> where
    T: RStore, 

Returns a mutable reference to the value being stored by this RData.

Panics if the RData is not storing a value of type T; if its value has been freed; or if the value is currently borrowed.

pub fn try_borrow_mut<T>(&self) -> Result<RRefMut<T>, GError> where
    T: RStore, 

Returns a mutable reference to the value being stored by this RData.

Returns an Err if the RData is not storing a value of type T; if its value has been freed; or if the value is currently borrowed.

pub fn take<T>(&self) -> Result<T, GError> where
    T: RStore, 

Takes the value stored in this RData and returns it.

Any future attempts to access the value will gracefully fail.

Returns an Err if the RData is not storing a value of type T; if its value has already been freed; or if it's currently borrowed.

pub fn free(&self) -> Result<(), GError>

Drops the value stored by this RData.

Any future attempts to access the value will gracefully fail.

Returns an Err if the RData is not storing a value of type T; if its value has already been freed; or if it's currently borrowed.

pub fn is_freed(&self) -> bool

Returns true if this RData's value has been taken or freed.

pub fn access_giter(rdata: &Root<RData>, giter: &Root<GIter>) -> Root<GIter>

Creates an indexing iterator for this collection.

Equivalent to [rdata iter].

pub fn get<S, R>(&self, key: S) -> Result<R, GError> where
    R: FromVal,
    S: ToSym, 

Accesses the value of a field or property.

Equivalent to [rdata key].

pub fn get_if_present<S, R>(&self, key: S) -> Result<Option<R>, GError> where
    R: FromVal,
    S: ToSym, 

Accesses the value of a field or property, if it exists.

Equivalent to [rdata (? key)].

pub fn set<S, V>(&self, key: S, val: V) -> Result<(), GError> where
    S: ToSym,
    V: ToVal, 

Mutates the field or property bound to the given name.

Equivalent to (= [rdata key] val).

pub fn set_if_present<S, V>(&self, key: S, val: V) -> Result<bool, GError> where
    S: ToSym,
    V: ToVal, 

Mutates the field or property bound to the given name, if any. Returns true if the field or property exists.

Equivalent to (= [rdata (? key)] val).

pub fn call<S, A, R>(&self, key: S, args: &A) -> Result<R, GError> where
    A: ToCallArgs + ?Sized,
    R: FromVal,
    S: ToSym, 

Invokes a method.

Equivalent to (call-meth rdata key ..args).

pub fn call_if_present<S, A, R>(
    &self,
    key: S,
    args: &A
) -> Result<Option<R>, GError> where
    A: ToCallArgs + ?Sized,
    R: FromVal,
    S: ToSym, 

Invokes a method, if it exists.

Equivalent to (call-meth rdata (? key) ..args).

pub fn has_meth<S>(&self, key: S) -> Result<bool, GError> where
    S: ToSym, 

Returns true if the given name is bound to a method.

Equivalent to (has-meth? rdata key).

pub fn try_eq(&self, other: &Root<RData>) -> Result<bool, GError>

Equivalent to (eq? self other).

Note that, because this may invoke an op-eq? method, it can potentially fail.

The same is true for PartialEq comparisons between RData using Rust's == operator. In that case, if an error occurs, the operator will panic.

Trait Implementations

impl Debug for RData

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

Formats the value using the given formatter.

impl Display for RData

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

Formats the value using the given formatter.

impl GStore for RData

impl<'a, 'r> MakeArg<'a> for &'r RData where
    'a: 'r, 

fn make_arg(temp: &'a mut Slot) -> Result<&'r RData, GError>

impl PartialEq<Root<RData>> for RData

fn eq(&self, other: &Root<RData>) -> bool

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.