Copyright | (c) 2011-2015 diagrams-core team (see LICENSE) |
---|---|
License | BSD-style (see LICENSE) |
Maintainer | diagrams-discuss@googlegroups.com |
Safe Haskell | None |
Language | Haskell2010 |
This module defines a type of names which can be used for referring to subdiagrams, and related types.
Names
Atomic names
Names
A (qualified) name is a (possibly empty) sequence of atomic names.
Eq Name Source | |
Ord Name Source | |
Show Name Source | |
Monoid Name Source | |
Semigroup Name Source | |
Wrapped Name Source | |
Qualifiable Name Source | Of course, names can be qualified using |
IsName Name Source | |
Rewrapped Name Name Source | |
Action Name (SubMap b v n m) | A name acts on a name map by qualifying every name in it. |
type Unwrapped Name = [AName] Source |
class (Typeable a, Ord a, Show a) => IsName a where Source
Class for those types which can be used as names. They must
support Typeable
(to facilitate extracting them from
existential wrappers), Ord
(for comparison and efficient
storage) and Show
.
To make an instance of IsName
, you need not define any methods,
just declare it.
WARNING: it is not recommended to use
GeneralizedNewtypeDeriving
in conjunction with IsName
, since
in that case the underlying type and the newtype
will be
considered equivalent when comparing names. For example:
newtype WordN = WordN Int deriving (Show, Ord, Eq, Typeable, IsName)
is unlikely to work as intended, since (1 :: Int)
and (WordN 1)
will be considered equal as names. Instead, use
newtype WordN = WordN Int deriving (Show, Ord, Eq, Typeable, IsName) instance IsName WordN
Nothing
IsName Bool Source | |
IsName Char Source | |
IsName Double Source | |
IsName Float Source | |
IsName Int Source | |
IsName Integer Source | |
IsName () Source | |
IsName Name Source | |
IsName AName Source | |
IsName a => IsName [a] Source | |
IsName a => IsName (Maybe a) Source | |
(IsName a, IsName b) => IsName (a, b) Source | |
(IsName a, IsName b, IsName c) => IsName (a, b, c) Source |
(.>) :: (IsName a1, IsName a2) => a1 -> a2 -> Name infixr 5 Source
Convenient operator for writing qualified names with atomic
components of different types. Instead of writing toName a1 <>
toName a2 <> toName a3
you can just write a1 .> a2 .> a3
.
Qualifiable
class Qualifiable q where Source
Instances of Qualifiable
are things which can be qualified by
prefixing them with a name.
Qualifiable Name Source | Of course, names can be qualified using |
Qualifiable a => Qualifiable [a] Source | |
(Ord a, Qualifiable a) => Qualifiable (Set a) Source | |
Qualifiable a => Qualifiable (TransInv a) Source | |
Qualifiable a => Qualifiable (b -> a) Source | |
(Qualifiable a, Qualifiable b) => Qualifiable (a, b) Source | |
Qualifiable a => Qualifiable (Map k a) Source | |
Qualifiable a => Qualifiable (Measured n a) Source | |
(Qualifiable a, Qualifiable b, Qualifiable c) => Qualifiable (a, b, c) Source | |
Qualifiable (SubMap b v n m) Source |
|
(Metric v, OrderedField n, Semigroup m) => Qualifiable (QDiagram b v n m) Source | Diagrams can be qualified so that all their named points can now be referred to using the qualification prefix. |