clash-lib-1.9.0: Clash: a functional hardware description language - As a library
Copyright(C) 2011-2013 Edward Kmett
LicenseBSD-style (see the file LICENSE)
MaintainerEdward Kmett <ekmett@gmail.com>
Stabilityprovisional
Portabilityportable
Safe HaskellTrustworthy
LanguageHaskell2010

Clash.Util.Supply

Description

A fast unique identifier supply with local pooling and replay support.

One often has a desire to generate a bunch of integer identifiers within a single process that are unique within that process. You could use UUIDs, but they can be expensive to generate; you don't want to have your threads contending for a single external counter if the identifier is not going to be used outside the process.

concurrent-supply builds a tree-like structure which can be split; you can make smaller unique supplies and then you allocate from your supplies locally. Internally it pulls from a unique supply one block at a time as you walk into parts of the tree that haven't been explored.

Synopsis

Documentation

data Supply Source #

A user managed globally unique variable supply.

Instances

Instances details
Eq Supply Source # 
Instance details

Defined in Clash.Util.Supply

Ord Supply Source # 
Instance details

Defined in Clash.Util.Supply

Show Supply Source # 
Instance details

Defined in Clash.Util.Supply

Hashable Supply Source # 
Instance details

Defined in Clash.Util.Supply

Variables

newSupply :: IO Supply Source #

Grab a new supply. Any two supplies obtained with newSupply are guaranteed to return disjoint sets of identifiers. Replaying the same sequence of operations on the same Supply will yield the same results.

freshId :: Supply -> (Unique, Supply) Source #

Obtain a fresh Id from a Supply.

splitSupply :: Supply -> (Supply, Supply) Source #

Split a supply into two supplies that will return disjoint identifiers

Unboxed API

freshId# :: Supply -> (# Unique#, Supply #) Source #

An unboxed version of freshId

splitSupply# :: Supply -> (# Supply, Supply #) Source #

An unboxed version of splitSupply