Data.Vector.HFixed.Class

Types and type classes

Peano numbers

data S n

Successor of n

Instances

Typeable1 S

Arity n => Index Z (S n)

Arity n => Arity (S n)

HomArity n a => HomArity (S n) a

Index k n => Index (S k) (S n)

Index n xs => Index (S n) (: * x xs)

data Z

Type level zero

Instances

Typeable Z

Arity Z

HomArity Z a

Arity n => Index Z (S n)

Arity xs => Index Z (: * x xs)

N-ary functions

type family Fn as b

Type family for N-ary function. Types of function parameters are encoded as the list of types.

newtype Fun as b

Newtype wrapper to work around of type families' lack of injectivity.

Constructors

Fun

Fields

unFun :: Fn as b

Instances

Arity xs => Monad (Fun xs)

Arity xs => Functor (Fun xs)

Arity xs => Applicative (Fun xs)

newtype TFun f as b

Newtype wrapper for function where all type parameters have same type constructor. This type is required for writing function which works with monads, appicatives etc.

Constructors

TFun

Fields

unTFun :: Fn (Wrap f as) b

Instances

Arity xs => Monad (TFun * f xs)

Arity xs => Functor (TFun * f xs)

Arity xs => Applicative (TFun * f xs)

funToTFun :: Fun (Wrap f xs) b -> TFun f xs b

Cast Fun to equivalent TFun

tfunToFun :: TFun f xs b -> Fun (Wrap f xs) b

Cast TFun to equivalent Fun

Type functions

data Proxy a

Constructors

Proxy

type family xs (++) ys :: [α]

Concaternation of type level lists.

type family Len xs :: *

Length of type list expressed as type level naturals from fixed-vector.

type family Wrap f a :: [β]

Wrap every element of list into type constructor

type family HomList n a :: [α]

Homogeneous type list with length n and element of type a. It uses type level natural defined in fixed-vector.

Type classes

class Arity (Len xs) => Arity xs where

Type class for dealing with N-ary function in generic way. Both accum and apply work with accumulator data types which are polymorphic. So it's only possible to write functions which rearrange elements in vector using plain ADT. It's possible to get around it by using GADT as accumulator (See ArityC and function which use it)

This is also somewhat a kitchen sink module. It contains witnesses which could be used to prove type equalities or to bring instance in scope.

Methods

accum

Arguments

:: (forall a as. t (a : as) -> a -> t as)

Step function. Applies element to accumulator.

-> (t `[]` -> b)

Extract value from accumulator.

-> t xs

Initial state.

-> Fn xs b

Fold over N elements exposed as N-ary function.

apply

Arguments

:: (forall a as. t (a : as) -> (a, t as))

Extract value to be applied to function.

-> t xs

Initial state.

-> ContVec xs

Apply values to N-ary function

applyM

Arguments

:: Monad m

=> (forall a as. t (a : as) -> m (a, t as))

Extract value to be applied to function

-> t xs

Initial state

-> m (ContVec xs)

Apply value to N-ary function using monadic actions

accumTy :: (forall a as. t (a : as) -> f a -> t as) -> (t `[]` -> b) -> t xs -> Fn (Wrap f xs) b

Analog of accum

applyTy :: (forall a as. t (a : as) -> (f a, t as)) -> t xs -> ContVecF xs f

Analog of apply which allows to works with vectors which elements are wrapped in the newtype constructor.

arity :: p xs -> Int

Size of type list as integer.

witWrapped :: WitWrapped f xs

witConcat :: Arity ys => WitConcat xs ys

witNestedFun :: WitNestedFun xs ys r

witLenWrap :: WitLenWrap f xs

Instances

Arity ([] *)

Arity xs => Arity (: * x xs)

class Arity xs => ArityC c xs where

Declares that every type in list satisfy constraint c

Methods

witAllInstances :: WitAllInstances c xs

Instances

ArityC c ([] *)

(c x, ArityC c xs) => ArityC c (: * x xs)

class Arity (Elems v) => HVector v where

Type class for heterogeneous vectors. Instance should specify way to construct and deconstruct itself

Note that this type class is extremely generic. Almost any single constructor data type could be made instance. It could be monomorphic, it could be polymorphic in some or all fields it doesn't matter. Only law instance should obey is:

 inspect v construct = v

Default implementation which uses Generic is provided.

Associated Types

type Elems v :: [*]

Methods

construct :: Fun (Elems v) v

Function for constructing vector

inspect :: v -> Fun (Elems v) a -> a

Function for deconstruction of vector. It applies vector's elements to N-ary function.

Instances

HVector ()

Unit is empty heterogeneous vector

HVector (Complex a)

Arity xs => HVector (ContVec xs)

Arity xs => HVector (VecList xs)

Arity xs => HVector (HVec xs)

HVector (a, b)

(Storable a, HomArity n a) => HVector (Vec n a)

(Unbox n a, HomArity n a) => HVector (Vec n a)

(Prim a, HomArity n a) => HVector (Vec n a)

HomArity n a => HVector (Vec n a)

(Arity (Wrap * * f xs), Arity xs) => HVector (HVecF xs f)

It's not possible to remove constrain Arity (Wrap f xs) because it's required by superclass and we cannot prove it for all f. witWrapped allow to generate proofs for terms

HVector (a, b, c)

HVector (a, b, c, d)

HVector (a, b, c, d, e)

HVector (a, b, c, d, e, f)

HVector (a, b, c, d, e, f, g)

class Arity (ElemsF v) => HVectorF v where

Type class for partially homogeneous vector where every element in the vector have same type constructor. Vector itself is parametrized by that constructor

Associated Types

type ElemsF v :: [*]

Elements of the vector without type constructors

Methods

inspectF :: v f -> TFun f (ElemsF v) a -> a

constructF :: TFun f (ElemsF v) (v f)

Instances

Arity xs => HVectorF (VecListF xs)

Arity xs => HVectorF (HVecF xs)

Arity xs => HVectorF (ContVecF * xs)

Witnesses

data WitWrapped f xs where

Witness that observe fact that if we have instance Arity xs than we have instance Arity (Wrap f xs).

Constructors

WitWrapped :: Arity (Wrap f xs) => WitWrapped f xs

data WitConcat xs ys where

Witness that observe fact that (Arity xs, Arity ys) implies Arity (xs++ys)

Constructors

WitConcat :: Arity (xs ++ ys) => WitConcat xs ys

data WitNestedFun xs ys r where

Observes fact that Fn (xs++ys) r ~ Fn xs (Fn ys r)

Constructors

WitNestedFun :: Fn (xs ++ ys) r ~ Fn xs (Fn ys r) => WitNestedFun xs ys r

data WitLenWrap f xs where

Observe fact than Len xs ~ Len (Wrap f xs)

Constructors

WitLenWrap :: Len xs ~ Len (Wrap f xs) => WitLenWrap f xs

data WitWrapIndex f n xs where

Proofs for the indexing of wrapped type lists.

Constructors

WitWrapIndex :: (ValueAt n (Wrap f xs) ~ f (ValueAt n xs), Index n (Wrap f xs), Arity (Wrap f xs)) => WitWrapIndex f n xs

data WitAllInstances c xs where

Witness that all elements of type list satisfy predicate c.

Constructors

WitAllInstancesNil :: WitAllInstances c `[]`

WitAllInstancesCons :: c x => WitAllInstances c xs -> WitAllInstances c (x : xs)

CPS-encoded vector

newtype ContVec xs

CPS-encoded heterogeneous vector.

Constructors

ContVec

Fields

runContVec :: forall r. Fun xs r -> r

Instances

Arity xs => HVector (ContVec xs)

newtype ContVecF xs f

CPS-encoded partially heterogeneous vector.

Constructors

ContVecF (forall r. TFun f xs r -> r)

Instances

Arity xs => HVectorF (ContVecF * xs)

toContVec :: ContVecF xs f -> ContVec (Wrap f xs)

toContVecF :: ContVec (Wrap f xs) -> ContVecF xs f

cons :: x -> ContVec xs -> ContVec (x : xs)

Cons element to the vector

consF :: f x -> ContVecF xs f -> ContVecF (x : xs) f

Cons element to the vector

Interop with homogeneous vectors

class (Arity n, Arity (HomList n a)) => HomArity n a where

Conversion between homogeneous and heterogeneous N-ary functions.

Methods

toHeterogeneous :: Fun n a r -> Fun (HomList n a) r

Convert n-ary homogeneous function to heterogeneous.

toHomogeneous :: Fun (HomList n a) r -> Fun n a r

Convert heterogeneous n-ary function to homogeneous.

Instances

HomArity Z a

HomArity n a => HomArity (S n) a

homInspect :: (Vector v a, HomArity (Dim v) a) => v a -> Fun (HomList (Dim v) a) r -> r

Default implementation of inspect for homogeneous vector.

homConstruct :: forall v a. (Vector v a, HomArity (Dim v) a) => Fun (HomList (Dim v) a) (v a)

Default implementation of construct for homogeneous vector.

Operations of Fun

Primitives for Fun

curryFun :: Fun (x : xs) r -> x -> Fun xs r

Apply single parameter to function

uncurryFun :: (x -> Fun xs r) -> Fun (x : xs) r

Uncurry N-ary function.

uncurryFun2 :: Arity xs => (x -> y -> Fun xs (Fun ys r)) -> Fun (x : xs) (Fun (y : ys) r)

curryMany :: forall xs ys r. Arity xs => Fun (xs ++ ys) r -> Fun xs (Fun ys r)

Curry first n arguments of N-ary function.

constFun :: Fun xs r -> Fun (x : xs) r

Add one parameter to function which is ignored.

stepFun :: (Fun xs a -> Fun ys b) -> Fun (x : xs) a -> Fun (x : ys) b

Transform function but leave outermost parameter untouched.

Primitives for TFun

curryTFun :: TFun f (x : xs) r -> f x -> TFun f xs r

Apply single parameter to function

uncurryTFun :: (f x -> TFun f xs r) -> TFun f (x : xs) r

Uncurry single parameter

uncurryTFun2 :: (Arity xs, Arity ys) => (f x -> f y -> TFun f xs (TFun f ys r)) -> TFun f (x : xs) (TFun f (y : ys) r)

Uncurry two parameters for nested TFun.

shuffleTF :: forall f x xs r. Arity xs => (x -> TFun f xs r) -> TFun f xs (x -> r)

Move first argument of function to its result. This function is useful for implementation of lens.

More complicated functions

concatF :: (Arity xs, Arity ys) => (a -> b -> c) -> Fun xs a -> Fun ys b -> Fun (xs ++ ys) c

Concatenate n-ary functions. This function combine results of both N-ary functions and merge their parameters into single list.

shuffleF :: forall x xs r. Arity xs => (x -> Fun xs r) -> Fun xs (x -> r)

Move first argument of function to its result. This function is useful for implementation of lens.

lensWorkerF :: forall f r x y xs. (Functor f, Arity xs) => (x -> f y) -> Fun (y : xs) r -> Fun (x : xs) (f r)

Helper for lens implementation.

class Arity n => Index n xs where

Indexing of vectors

Associated Types

type ValueAt n xs :: *

Type at position n

type NewElems n xs a :: [*]

List of types with n'th element replaced by a.

Methods

getF :: n -> Fun xs (ValueAt n xs)

Getter function for vectors

putF :: n -> ValueAt n xs -> Fun xs r -> Fun xs r

Putter function. It applies value x to nth parameter of function.

lensF :: (Functor f, v ~ ValueAt n xs) => n -> (v -> f v) -> Fun xs r -> Fun xs (f r)

Helper for implementation of lens

lensChF :: Functor f => n -> (ValueAt n xs -> f a) -> Fun (NewElems n xs a) r -> Fun xs (f r)

Helper for type-changing lens

witWrapIndex :: WitWrapIndex f n xs

Instances

Arity xs => Index Z (: * x xs)

Index n xs => Index (S n) (: * x xs)