Struct AtomicAVal

pub struct AtomicAVal(/* private fields */);

WLambda:

!atom = std:sync:atom:new 10;
!channel = std:sync:mpsc:new[];
!thrd = std:spawn_thread $q{
    !val = main.read;
    main.write $[1,$[0,1],3];

    main.read_at 0;
    main.write_at $[1, 0] 320;
    q.send $["done", 10];

} ${ main = atom, q = channel };

!item = queue.pop[];
.item = queue.pop_timeout 1000;

Wraps an AVal like this: Arc<RwLock>. An AtomicAVal is a thread safe container for VVal data structures. It’s used by WLambda functions like std:sync:atom:new, std:sync:atom:read or std:sync:atom:write.

These containers are shared between the threads by passing them to the threads at std:thread:spawn.

Implementations

impl AtomicAVal

pub fn new() -> Self

Creates a new empty instance, containing AVal::None.

pub fn write(&self, vv: &VVal) -> VVal

Locks and stores the VVal.

pub fn swap(&self, vv: &VVal) -> VVal

Locks and stores the VVal.

pub fn read(&self) -> VVal

Locks and reads the AVal and converts it to a VVal.

pub fn store_at(&self, _keypath: &VVal, vv: &VVal)

Locks and stores the VVal at the given key path.

pub fn read_at(&self, _keypath: &VVal) -> VVal

Locks and reads the AVal at the given key path.

Trait Implementations

impl Clone for AtomicAVal

fn clone(&self) -> AtomicAVal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AtomicAVal

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

Formats the value using the given formatter.

impl Default for AtomicAVal

fn default() -> Self

Returns the “default value” for a type.

impl VValUserData for AtomicAVal

fn as_any(&mut self) -> &mut dyn Any

This should be implemented simply by returning a mutable reference to the concrete type self. It allows you to access your data structure from inside a function yourself.

fn call_method(&self, key: &str, env: &mut Env) -> Result<VVal, StackAction>

This method is called, when the user data object is used in a method call directly. Use this to implement convenient APIs for the user of the user data object. To quickly get the arguments you may use env.argv_ref().

fn clone_ud(&self) -> Box<dyn VValUserData>

Should clone your user data instance. Whether you are doing a deep clone or a shallow clone or something else is up to you.

fn s(&self) -> String

This method should return a human readable syntax representation of your VValUserData.

fn s_raw(&self) -> String

If your data has a plain string representation, you can return the string directly from here.

fn i(&self) -> i64

Returns the i64 representation of your data.

fn byte(&self) -> u8

Returns the byte representation of your data.

fn c(&self) -> char

Returns the char representation of your data.

fn f(&self) -> f64

Returns the f64 representation of your data.

fn b(&self) -> bool

Returns the boolean representation of your data. Can for instance be used to check if your data is valid or something.

fn eqv(&self, _other: &Box<dyn VValUserData>) -> bool

Allows you to specify how two instances of your data should be compared for equivalentness.

fn set_key(&self, _key: &VVal, _val: VVal) -> Result<(), StackAction>

Makes your user data act like a map. This can be useful for implementing your own registries or data structures. Implement this method for setting a key to a value.

fn delete_key(&self, _key: &VVal) -> Result<VVal, StackAction>

This method is called when the user wants to remove a key. Typically called when std:delete from the prelude is called.

fn get_key(&self, _key: &str) -> Option<VVal>

This method returns some value that your user data associates with the given key.

fn call(&self, _env: &mut Env) -> Result<VVal, StackAction>

This method is called when the user data is called. To quickly get the arguments you may use env.argv_ref().

fn as_thread_safe_usr(&mut self) -> Option<Box<dyn ThreadSafeUsr>>

This function is called when you try to pass a user data value between threads via the Atoms provided by the thread implementation of WLambda.