const classafConcurrent::AtomicMap

sys::Obj
  afConcurrent::AtomicMap

@Js

A Map that provides fast reads and lightweight writes between threads using the copy on write paradigm.

The map is stored in an AtomicRef through which all reads are made. Writing makes a rw copy of the map and is thus a more expensive operation.

CAUTION: Write operations ( getOrAdd, set, remove & clear ) are not synchronised. This makes them lightweight but also susceptible to data-loss during race conditions. Though this may be acceptable for caching situations where values are re-calculated on demand.

All values held in the map must be immutable, except if you're caching funcs in a Javascipt environment.

See the article From One Thread to Another... for more details.

caseInsensitive

Source

const Bool caseInsensitive := false

Configures case sensitivity for maps with Str keys.

AtomicMap() { it.keyType = Str#; it.caseInsensitive = true }

clear

Source

This clear()

Remove all key/value pairs from the map. Return this.

containsKey

Source

Bool containsKey(Obj key)

Returns true if the map contains the given key

def

Source

const Obj? def := null

The default value to use for get when a key isn't mapped.

each

Source

Void each(|Obj?,Obj c)

Call the specified function for every key/value in the map.

get

Source

@Operator Obj? get(Obj key, Obj? def := this.def)

Returns the value associated with the given key. If key is not mapped, then return the value of the def parameter. If def is omitted it defaults to null.

getOrAdd