mooncakes.io

🥮 mooncakes.io

mizchi

builtins

atomics

builtins
→
core
→
examples
→
mbtconv
→
node
→
wasm
→
web
→
README
U
AbortController
U
AbortSignal
U
AggregateError
U
Any
U
ArrayBuffer
U
AsyncDisposableStack
U
AsyncIterator
U
Atomics
U
AtomicsWaitResult
U
BigInt64Array
U
BigUint64Array
U
DataView
U
Date
U
DisposableStack
U
EvalError
U
FinalizationRegistry
U
Float32Array
U
Float64Array
U
Function
U
Int16Array
U
Int32Array
U
Int8Array
U
JSON
U
JsArray
U
JsBigInt
U
JsError
U
JsIterator
U
JsMap
U
JsSet
U
JsString
U
Math
U
Nullable
U
Nullish
U
Object
U
Promise
U
PromiseResolvers
U
Proxy
U
RangeError
U
ReferenceError
U
Reflect
U
RegExp
U
RegExpMatchArray
U
RegExpResult
U
SharedArrayBuffer
U
Symbol
U
SyntaxError
U
ThrowError
U
Timer
U
TypeError
U
TypedArray
U
URIError
U
Uint16Array
U
Uint32Array
U
Uint8Array
U
WeakMap
U
WeakRef
U
WeakSet
V
any
V
atob
V
btoa
V
clearInterval
V
clearTimeout
V
decodeURI
V
decodeURIComponent
V
dynamic_import
V
encodeURI
V
encodeURIComponent
V
from_async
V
from_entries
V
from_fn0
V
from_fn1
V
from_fn2
V
from_fn3
V
globalThis
V
identity
V
isFinite
V
isNaN
V
log
V
new
V
new_array
V
new_object
V
parseFloat
V
parseInt
V
promisify0
V
promisify1
V
promisify2
V
promisify3
V
queueMicrotask
V
run_async
V
setInterval
V
setTimeout
V
structuredClone
V
suspend
V
symbol
V
throwable
V
typeof_
V
undefined

README

mizchi/js/builtins/atomics does not have a README file

#
Atomics

source

#external
pub type Atomics

JavaScript Atomics namespace object

#
Atomics::add

source

fn Atomics::add(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically adds a value to the value at the given position in the array. Returns the old value at that index.

Example

let sab = SharedArrayBuffer::new(1024)
let ta = Uint8Array::new(sab)
Atomics::add(ta, 0, 12)  // returns 0 (the old value)
Atomics::load(ta, 0)     // 12 (the new value)

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/add

#
Atomics::and_

source

fn Atomics::and_(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically computes a bitwise AND with a value at the given position. Returns the old value at that index.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/and

#
Atomics::compareExchange

source

fn Atomics::compareExchange(typedArray : @mizchi/js/core.Any
Any, index : Int, expectedValue : Int, replacementValue : Int) -> Int

Atomically stores a value at the given position, if it equals the expected value. Returns the old value.

Example

let ta = Int32Array::new(sab)
Atomics::store(ta, 0, 5)
Atomics::compareExchange(ta, 0, 5, 12)  // returns 5
Atomics::load(ta, 0)                     // 12

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/compareExchange

#
Atomics::exchange

source

fn Atomics::exchange(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically stores a value at the given position in the array. Returns the old value.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/exchange

#
Atomics::isLockFree

source

fn Atomics::isLockFree(size : Int) -> Bool

Returns true if an atomic operation on arrays of the given element size will be implemented using a hardware atomic operation (as opposed to a lock).

Example

Atomics::isLockFree(1)  // true
Atomics::isLockFree(2)  // true
Atomics::isLockFree(4)  // true
Atomics::isLockFree(8)  // true (on 64-bit systems)

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/isLockFree

#
Atomics::load

source

fn Atomics::load(typedArray : @mizchi/js/core.Any
Any, index : Int) -> Int

Atomically returns the value at the given position in the array.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/load

#
Atomics::notify

source

fn Atomics::notify(typedArray : @mizchi/js/core.Any
Any, index : Int, count? : Int) -> Int

Notifies agents waiting on the given index of the array. Returns the number of agents that were notified.

Note: Also known as Atomics.wake() in older specifications.

Example

Atomics::notify(ia, 0, count=1)  // Notify 1 agent waiting on index 0

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/notify

#
Atomics::or_

source

fn Atomics::or_(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically computes a bitwise OR with a value at the given position. Returns the old value at that index.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/or

#
Atomics::store

source

fn Atomics::store(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically stores a value at the given position in the array. Returns the value that was stored.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/store

#
Atomics::sub

source

fn Atomics::sub(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically subtracts a value from the value at the given position. Returns the old value at that index.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/sub

#
Atomics::wait

source

fn Atomics::wait(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int, timeout? : Int) -> AtomicsWaitResult

Verifies that the given position in the array still contains a value and sleeps awaiting or times out. Returns Ok, NotEqual, or TimedOut.

Note: This operation is only allowed in workers, not on the main thread.

Example

let result = Atomics::wait(ia, 0, 0, timeout=1000)
match result {
  Ok => println("Woken up")
  NotEqual => println("Value changed")
  TimedOut => println("Timed out")
}

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/wait

#
Atomics::xor

source

fn Atomics::xor(typedArray : @mizchi/js/core.Any
Any, index : Int, value : Int) -> Int

Atomically computes a bitwise XOR with a value at the given position. Returns the old value at that index.

MDN: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/xor

#
AtomicsWaitResult

source

pub enum AtomicsWaitResult {
  Ok
  NotEqual
  TimedOut
} derive(Eq)

Wait result returned by wait()

impl Show for AtomicsWaitResult

Source Files

atomics.mbt

Site source Report issue Packages Build queue Skills Statistics

#Atomics

#Atomics::add

Example

#Atomics::and_

#Atomics::compareExchange

Example

#Atomics::exchange

#Atomics::isLockFree

Example

#Atomics::load

#Atomics::notify

Example

#Atomics::or_

#Atomics::store

#Atomics::sub

#Atomics::wait

Example

#Atomics::xor

#AtomicsWaitResult

Source Files

#
Atomics

#
Atomics::add

#
Atomics::and_

#
Atomics::compareExchange

#
Atomics::exchange

#
Atomics::isLockFree

#
Atomics::load

#
Atomics::notify

#
Atomics::or_

#
Atomics::store

#
Atomics::sub

#
Atomics::wait

#
Atomics::xor

#
AtomicsWaitResult