-- Hoogle documentation, generated by Haddock
-- See Hoogle, http://www.haskell.org/hoogle/


-- | Vector builder
--   
--   An API for efficient construction of vectors with abstraction over
--   their size.
@package vector-builder
@version 0.1


-- | Extensions to the standard mutable Vector API.
module VectorBuilder.MVector

-- | Construct a mutable vector from a builder.
build :: Builder element -> ST s (MVector s element)


-- | Extensions to the standard immutable Vector API.
module VectorBuilder.Vector

-- | Construct a vector from a builder.
build :: Builder element -> Vector element

module VectorBuilder.Builder

-- | An abstraction over the size of a vector for the process of its
--   construction.
--   
--   It postpones the actual construction of a vector until the execution
--   of the builder.
data Builder element

-- | Empty builder.
empty :: Builder element

-- | Builder of a single element.
singleton :: element -> Builder element

-- | Builder from a vector of elements.
vector :: Vector element -> Builder element