A label

This class gives the string associated with a type-level symbol. There are instances of the class for every concrete literal: "hello", etc.

Since: base-4.7.0.0

Are all of the labels in this Row unique?

A convenient way to provide common, easy constraints

The variant type.

The kind of rows. This type is only used as a datakind. A row is a typelevel entity telling us which symbols are associated with which types.

Type level version of empty

A lower fixity operator for type equality

Alias for (r .! l) ≈ a. It is a class rather than an alias, so that it can be partially applied.

A pattern for variants; can be used to both destruct a variant when in a pattern position or construct one in an expression position.

A quick constructor to create a singleton variant.

Initialize a variant from a producer function that accepts labels. If this function returns more than one possibility, then one is chosen arbitrarily to be the value in the variant.

Does the row lack (i.e. it does not have) the specified label?

Alias for .\. It is a class rather than an alias, so that it can be partially applied.

The minimum join of the two rows.

Make the variant arbitrarily more diverse.

Type level Row append

If the variant exists at the given label, update it to the given value. Otherwise, do nothing.

If the variant exists at the given label, focus on the value associated with it. Otherwise, do nothing.

Type level Row modification

Rename the given label.

Type level row renaming

A Variant with no options is uninhabited.

Convert a variant into either the value at the given label or a variant without that label. This is the basic variant destructor.

A version of trial that ignores the leftover variant.

A trial over multiple types

A convenient function for using view patterns when dispatching variants. For example:

 myShow :: Var ("y" '::= String :| "x" '::= Int :| Empty) -> String
 myShow (view x -> Just n) = "Int of "++show n
 myShow (view y -> Just s) = "String of "++s

Arbitrary variant restriction. Turn a variant into a subset of itself.

Split a variant into two sub-variants.

Type level label fetching

Type level Row element removal

Type level Row difference. That is, l .\\ r is the row remaining after removing any matching elements of r from l.

A type level way to create a singleton Row.

Map a type level function over a Row.

A function to map over a variant given a constraint.

A function to map over a variant given no constraint.

Lifts a natrual transformation over a variant. In other words, it acts as a variant transformer to convert a variant of f a values to a variant of g a values. If no constraint is needed, instantiate the first type argument with Unconstrained1.

A form of transformC that doesn't have a constraint on a

Any structure over a row in which every element is similarly constrained can be metamorphized into another structure over the same row.

A standard fold

A fold with labels

A fold over two row type structures at once

Applicative sequencing over a variant

Convert from a variant where two functors have been mapped over the types to one where the composition of the two functors is mapped over the types.

Convert from a variant where the composition of two functors have been mapped over the types to one where the two functors are mapped individually one at a time over the types.

Return a list of the labels in a row type.

An unsafe way to make a Variant. This function does not guarantee that the labels are all unique.

A helper function for unsafely adding an element to the front of a variant. This can cause the type of the resulting variant to be malformed, for instance, if the variant already contains labels that are lexicographically before the given label. Realistically, this function should only be used when writing calls to metamorph.