MyNixOS website logo
Description

Haskell values that cannot be evaluated immediately.

Procrastinating variables (PVars) are meant to be used in cases where you want to give someone a value that you do not have available yet, but will definitely have ready by the time that they need to use it.

PVars have the advantage that you do not make the user of your value execute some kind of unwrapping routine in order to get access to the value within. For example, this is useful when you are constructing closures that you want to go ahead and construct now even though some of the values that they contain are not available yet.

PVars are implemented with a lazy thunk that reads from an IORef; before the IORef is written to, it contains _|_ (an exception with a descriptive error message) so that an error is raised in the user code if the variable is accidently accessed before the value is ready.

NOTE: PVars are modeled closely on the IVar implementation in the ivar-simple package. The major difference is that if you try to read an IVar before it has been given a value, it blocks until the value is available, whereas reading from a PVar before it is ready raises an exception. The reason behind the different symantics for PVar is because if the user accidently accesses the value too early, you want there to be a lot of noise to let him or her know about it, rather than merely blocking the thread indefinitely and causing them to wonder what went wrong.

Metadata

Version

1.0.2

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows