Personal tools

Type

From HaskellWiki

(Difference between revisions)
Jump to: navigation, search
m (Fix other links to type class)
m (Type and newtype: Programming guidelines#Records)
 
(5 intermediate revisions by 5 users not shown)
Line 7: Line 7:
 
One introduces, or declares, a type in Haskell via the <code>data</code> statement. In general a data declaration looks like:
 
One introduces, or declares, a type in Haskell via the <code>data</code> statement. In general a data declaration looks like:
   
data [context =>] type tv1 ... tvi = con1 c1t1 c1c2... c1tn |
+
data [context =>] type tv1 ... tvi = con1 c1t1 c1t2... c1tn |
 
... | conm cmt1 ... cmtq
 
... | conm cmt1 ... cmtq
 
[deriving]
 
[deriving]
Line 26: Line 26:
 
data Maybe a = Just a | Nothing
 
data Maybe a = Just a | Nothing
 
</haskell>
 
</haskell>
What this means is that the type '''Maybe''' has one type variable, represented by the ''a'' and two [[constructor]]s '''Just''' and '''Nothing'''. (Note that Haskell requires type names and constructor names to begin with an uppercase letter). The '''Just''' constructor takes one parameter, ''a''.
+
What this means is that the type '''Maybe''' has one type variable, represented by the ''a'' and two [[constructor]]s '''Just''' and '''Nothing'''. (Note that Haskell requires type names and constructor names to begin with an uppercase letter). The '''Just''' constructor takes one parameter, of type ''a''.
   
 
As another example, consider binary [[Tree]]s. They could be represented by:
 
As another example, consider binary [[Tree]]s. They could be represented by:
Line 33: Line 33:
 
</haskell>
 
</haskell>
 
Here, one of the constructors, '''Branch''' of '''Tree''' takes two trees as
 
Here, one of the constructors, '''Branch''' of '''Tree''' takes two trees as
parameters to the constructor, while '''Leaf''' takes the type variable ''a''. This type of recursion is a very common [[:Category:Idioms |pattern]] in Haskell.
+
parameters to the constructor, while '''Leaf''' takes a value of type ''a''. This type of recursion is a very common [[:Category:Idioms |pattern]] in Haskell.
   
 
==Type and newtype==
 
==Type and newtype==
Line 63: Line 63:
 
unFirstName (FirstName s) = s
 
unFirstName (FirstName s) = s
 
</haskell>
 
</haskell>
This is often done by the use of [[field]]s in the <code>newtype</code>. (Note
+
This is often done by the use of [[field|field labels]] in the <code>newtype</code>. (Note
 
that many consider the Haskell field implementation sub-optimal, while
 
that many consider the Haskell field implementation sub-optimal, while
others use it extensively. See [[Programming guidelines]] and [[Future of Haskell]])
+
others use it extensively. See [[Programming guidelines#Records|Programming guidelines]] and [[Future of Haskell]])
   
 
==A simple example==
 
==A simple example==
Line 82: Line 82:
 
</haskell>
 
</haskell>
 
Each of these uses a [[deriving]] clause to allow us to convert them from / to [[String]] and Int, test them for equality and ordering. With types like this,
 
Each of these uses a [[deriving]] clause to allow us to convert them from / to [[String]] and Int, test them for equality and ordering. With types like this,
where there are no [[type variable]]s, equality is based upon which constructor is used and order by the order you wrote them. e.g. <code>Three</code> is less than <code>Queen</code>.
+
where there are no [[type variable]]s, equality is based upon which constructor is used and order is determined by the order you wrote them, e.g. <code>Three</code> is less than <code>Queen</code>.
   
 
Now we define an actual <code>Card</code>
 
Now we define an actual <code>Card</code>
 
<haskell>
 
<haskell>
data Card = Card {value::CardValue,
+
data Card = Card {value :: CardValue,
suit::Suit}
+
suit :: Suit}
 
deriving (Read, Show, Eq)
 
deriving (Read, Show, Eq)
 
</haskell>
 
</haskell>
Line 95: Line 95:
 
specific types, <code>CardValue</code> and <code>Suit</code>.
 
specific types, <code>CardValue</code> and <code>Suit</code>.
   
The deriving clause here only specifies three of our desired [[Type class|Class]]es, we supply [[instance]] declarations for [[Ord]] and [[Enum]].
+
The deriving clause here only specifies three of our desired [[Type class|classes]], we supply [[instance]] declarations for [[Ord]] and [[Enum]]:
 
<haskell>
 
<haskell>
 
instance Ord Card where
 
instance Ord Card where
compare c1 c2 | (value c1 == (value c2)) = compare (suit c1) (suit c2)
+
compare c1 c2 = compare (value c1, suit c1) (value c2, suit c2)
| otherwise = compare (value c1) (value c2)
 
   
 
instance Enum Card where
 
instance Enum Card where
toEnum n = Card (toEnum (n `div` 4)) (toEnum (n `mod` 4))
+
toEnum n = let (v,s) = n`divMod`4 in Card (toEnum v) (toEnum s)
fromEnum c = 4*(fromEnum (value c)) + (fromEnum (suit c))
+
fromEnum c = fromEnum (value c) * 4 + fromEnum (suit c)
 
</haskell>
 
</haskell>
 
Finally, we alias the type <code>Deck</code> to a list of <code>Card</code>s
 
Finally, we alias the type <code>Deck</code> to a list of <code>Card</code>s
Line 118: Line 118:
   
 
==See also==
 
==See also==
Read the (wanted) articles about data [[constructor]]s and [[Type class|class]]es. As well the
+
Read the articles about data [[constructor]]s and [[Type class|class]]es. As well the
 
[http://haskell.org/definition/haskell98-report.pdf Haskell 98 report] and
 
[http://haskell.org/definition/haskell98-report.pdf Haskell 98 report] and
 
your chosen implementation (e.g. [[GHC/Documentation]]) have the latest words.
 
your chosen implementation (e.g. [[GHC/Documentation]]) have the latest words.
Line 132: Line 132:
 
*[[Reified type]], [[Non-trivial type synonyms]], [[Abstract data type]], [[Concrete data type]], [[Algebraic data type]].
 
*[[Reified type]], [[Non-trivial type synonyms]], [[Abstract data type]], [[Concrete data type]], [[Algebraic data type]].
 
*[[Research_papers/Type_systems]] allow the curious to delve deeper.
 
*[[Research_papers/Type_systems]] allow the curious to delve deeper.
  +
  +
Languages: [[型|ja]]

Latest revision as of 12:18, 31 July 2012

In Haskell, types are how you describe the data your program will work with.

Contents

[edit] 1 Data declarations

One introduces, or declares, a type in Haskell via the data statement. In general a data declaration looks like:

data [context =>] type tv1 ... tvi = con1  c1t1 c1t2... c1tn |
                      ... | conm cmt1 ... cmtq
                    [deriving]

which probably explains nothing if you don't already know Haskell!

The essence of the above statement is that you use the keyword
data
,

supply an optional context, give the type name and a variable number of type variables. This is then followed by a variable number of constructors, each of which has a list of type variables or type constants. At the end, there is an optional deriving.

There are a number of other subtleties associated with this, such as requiring parameters to the data constructors to be eager, what classes are allowed in the deriving, use of field names in the constructors and what the context actually does. Please refer to the specific articles for more on each of those.

Let's look at some examples. The Haskell standard data type Maybe is typically declared as:

 data Maybe a = Just a | Nothing

What this means is that the type Maybe has one type variable, represented by the a and two constructors Just and Nothing. (Note that Haskell requires type names and constructor names to begin with an uppercase letter). The Just constructor takes one parameter, of type a.

As another example, consider binary Trees. They could be represented by:

 data Tree a = Branch (Tree a) (Tree a) | Leaf a

Here, one of the constructors, Branch of Tree takes two trees as parameters to the constructor, while Leaf takes a value of type a. This type of recursion is a very common pattern in Haskell.

[edit] 2 Type and newtype

The other two ways one may introduce types to Haskell programs are via the

type
and
newtype
statements.
type
introduces a synonym for a type and uses the same data constructors.
newtype
introduces a renaming of a type and

requires you to provide new constructors.

When using a
type
declaration, the type synonym and its base type

are interchangeble almost everywhere (There are some restrictions when dealing with instance declarations). For example, if you had the declaration:

 type Name = String
then any function you had declared that had
String
in its

signature could be used on any element of type Name

However, if one had the declaration:

 
  newtype FirstName = FirstName String

this would no longer be the case. Functions would have to be declared that actually were defined on FirstName. Often, one creates a deconstructor at the same time which helps alleviate this requirement. e.g.:

  unFirstName :: FirstName -> String
  unFirstName (FirstName s) = s

This is often done by the use of field labels in the newtype. (Note that many consider the Haskell field implementation sub-optimal, while others use it extensively. See Programming guidelines and Future of Haskell)

[edit] 3 A simple example

Suppose you want to create a program to play bridge. You need something to represent cards. Here is one way to do that.

First, create data types for the suit and card number.

 data Suit = Club | Diamond | Heart | Spade
     deriving (Read, Show, Enum, Eq, Ord)
 
 data CardValue = Two | Three | Four
     | Five | Six | Seven | Eight | Nine | Ten 
     | Jack | Queen | King | Ace
    deriving (Read,  Show, Enum, Eq, Ord)

Each of these uses a deriving clause to allow us to convert them from / to String and Int, test them for equality and ordering. With types like this, where there are no type variables, equality is based upon which constructor is used and order is determined by the order you wrote them, e.g. Three is less than Queen.

Now we define an actual Card

 
 data Card = Card {value :: CardValue, 
                    suit :: Suit}
    deriving (Read, Show, Eq)

In this definition, we use fields, which give us ready made functions to access the two parts of a Card. Again, type variables were not used, but the data constructor requires its two parameters to be of specific types, CardValue and Suit.

The deriving clause here only specifies three of our desired classes, we supply instance declarations for Ord and Enum:

 instance Ord Card where
      compare c1 c2 = compare (value c1, suit c1) (value c2, suit c2)
 
 instance Enum Card where
      toEnum n  = let (v,s) = n`divMod`4 in Card (toEnum v) (toEnum s)
      fromEnum c = fromEnum (value c) * 4 + fromEnum (suit c)

Finally, we alias the type Deck to a list of Cards and populate the deck with a list comprehension

 type Deck = [Card]
 
 deck::Deck
 deck = [Card val su | val <- [Two .. Ace], su <- [Club .. Spade]]

[edit] 4 Please add

Further illustrative examples would be most appreciated.

[edit] 5 See also

Read the articles about data constructors and classes. As well the Haskell 98 report and your chosen implementation (e.g. GHC/Documentation) have the latest words.

Languages: ja