A PrimVar behaves like a single-element mutable primitive array.
Constructors
PrimVar (MutablePrimArray s a)
Moduleprimitive-0.9.1.0Haskell2010
Data.Primitive.PrimVar
Variant of MutVar that has one less indirection for primitive types.
The difference is illustrated by comparing MutVar Int and PrimVar Int:
MutVar Int:MutVar# --> I#PrimVar Int:MutableByteArray#
This module is adapted from a module in Edward Kmett's prim-ref library.
- 1 type
- 17 values
- Packageprimitive-0.9.1.0
- Exports18
- LanguageHaskell2010
- LicenceBSD-3-Clause
- SourcePrimVar.hs
Primitive References
9 declarationsCreate a primitive reference.
Create a pinned primitive reference.
Create a pinned primitive reference with the appropriate alignment for its contents.
Read a value from the PrimVar.
Write a value to the PrimVar.
Mutate the contents of a PrimVar.
Yield a pointer to the data of a PrimVar. This operation is only safe on pinned byte arrays allocated by newPinnedPrimVar or newAlignedPinnedPrimVar.
Convert a PrimVar to a one-elment MutablePrimArray.
Atomic Operations
9 declarationsAtomic operations on `PrimVar s Int`. All atomic operations imply a full memory barrier.
Given a primitive reference, the expected old value, and the new value, perform an atomic compare and swap i.e. write the new value if the current value matches the provided old value. Returns the value of the element before the operation.
Given a reference, and a value to add, atomically add the value to the element. Returns the value of the element before the operation.
Given a reference, and a value to subtract, atomically subtract the value from the element. Returns the value of the element before the operation.
Given a reference, and a value to bitwise and, atomically and the value with the element. Returns the value of the element before the operation.
Given a reference, and a value to bitwise nand, atomically nand the value with the element. Returns the value of the element before the operation.
Given a reference, and a value to bitwise or, atomically or the value with the element. Returns the value of the element before the operation.
Given a reference, and a value to bitwise xor, atomically xor the value with the element. Returns the value of the element before the operation.
Given a reference, atomically read an element.
Given a reference, atomically write an element.