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 # | |
Semigroup Name Source # | |
Monoid 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 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
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. |