X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=ghc%2Fcompiler%2FhsSyn%2FHsDecls.lhs;h=32e0a8cf8bd04b4fc6a07c65ac57a7048f4bac25;hb=960223bfc3fd1c2ac4608b837fb83f3bc6b5fd16;hp=324b811fdf1508155e190579cc81d2d4737edecf;hpb=a77abe6a30ea2763cfa1c0ca83cdce9b7200ced2;p=ghc-hetmet.git diff --git a/ghc/compiler/hsSyn/HsDecls.lhs b/ghc/compiler/hsSyn/HsDecls.lhs index 324b811..32e0a8c 100644 --- a/ghc/compiler/hsSyn/HsDecls.lhs +++ b/ghc/compiler/hsSyn/HsDecls.lhs @@ -1,59 +1,108 @@ % -% (c) The GRASP/AQUA Project, Glasgow University, 1992-1996 +% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998 % \section[HsDecls]{Abstract syntax: global declarations} -Definitions for: @FixityDecl@, @TyDecl@ and @ConDecl@, @ClassDecl@, -@InstDecl@, @DefaultDecl@. +Definitions for: @TyDecl@ and @ConDecl@, @ClassDecl@, +@InstDecl@, @DefaultDecl@ and @ForeignDecl@. \begin{code} -#include "HsVersions.h" - -module HsDecls where +module HsDecls ( + HsDecl(..), TyClDecl(..), InstDecl(..), RuleDecl(..), RuleBndr(..), + DefaultDecl(..), ForeignDecl(..), ForKind(..), + ExtName(..), isDynamic, + ConDecl(..), ConDetails(..), BangType(..), + IfaceSig(..), SpecDataSig(..), + hsDeclName, tyClDeclName, isClassDecl, isSynDecl, isDataDecl, countTyClDecls + ) where -import Ubiq +#include "HsVersions.h" -- friends: -import HsLoop ( nullMonoBinds, MonoBinds, Sig ) -import HsPragmas ( DataPragmas, ClassPragmas, - InstancePragmas, ClassOpPragmas - ) +import HsBinds ( HsBinds, MonoBinds, Sig, FixitySig(..), nullMonoBinds ) +import HsExpr ( HsExpr ) +import HsPragmas ( DataPragmas, ClassPragmas ) import HsTypes +import HsCore ( UfExpr, UfBinder, IfaceSig(..), UfRuleBody ) +import BasicTypes ( Fixity, NewOrData(..) ) +import CallConv ( CallConv, pprCallConv ) +import Var ( TyVar ) -- others: -import Name ( pprSym, pprNonSym ) -import Outputable ( interppSP, interpp'SP, - Outputable(..){-instance * []-} - ) -import Pretty +import PprType +import Outputable import SrcLoc ( SrcLoc ) -import Util ( cmpList, panic#{-ToDo:rm eventually-} ) +import Util \end{code} + %************************************************************************ %* * -\subsection[FixityDecl]{A fixity declaration} +\subsection[HsDecl]{Declarations} %* * %************************************************************************ \begin{code} -data FixityDecl name - = InfixL name Int - | InfixR name Int - | InfixN name Int +data HsDecl name pat + = TyClD (TyClDecl name pat) + | InstD (InstDecl name pat) + | DefD (DefaultDecl name) + | ValD (HsBinds name pat) + | ForD (ForeignDecl name) + | SigD (IfaceSig name) + | FixD (FixitySig name) + | RuleD (RuleDecl name pat) + +-- NB: all top-level fixity decls are contained EITHER +-- EITHER FixDs +-- OR in the ClassDecls in TyClDs +-- +-- The former covers +-- a) data constructors +-- b) class methods (but they can be also done in the +-- signatures of class decls) +-- c) imported functions (that have an IfacSig) +-- d) top level decls +-- +-- The latter is for class methods only \end{code} \begin{code} -instance (NamedThing name, Outputable name) - => Outputable (FixityDecl name) where - ppr sty (InfixL var prec) = print_it sty "l" prec var - ppr sty (InfixR var prec) = print_it sty "r" prec var - ppr sty (InfixN var prec) = print_it sty "" prec var - -print_it sty suff prec var - = ppBesides [ppStr "infix", ppStr suff, ppSP, ppInt prec, ppSP, pprSym sty var] +#ifdef DEBUG +hsDeclName :: (Outputable name, Outputable pat) + => HsDecl name pat -> name +#endif +hsDeclName (TyClD decl) = tyClDeclName decl +hsDeclName (SigD (IfaceSig name _ _ _)) = name +hsDeclName (InstD (InstDecl _ _ _ name _)) = name +hsDeclName (ForD (ForeignDecl name _ _ _ _ _)) = name +hsDeclName (FixD (FixitySig name _ _)) = name +-- Others don't make sense +#ifdef DEBUG +hsDeclName x = pprPanic "HsDecls.hsDeclName" (ppr x) +#endif + +tyClDeclName :: TyClDecl name pat -> name +tyClDeclName (TyData _ _ name _ _ _ _ _) = name +tyClDeclName (TySynonym name _ _ _) = name +tyClDeclName (ClassDecl _ name _ _ _ _ _ _ _ _) = name \end{code} +\begin{code} +instance (Outputable name, Outputable pat) + => Outputable (HsDecl name pat) where + + ppr (TyClD dcl) = ppr dcl + ppr (SigD sig) = ppr sig + ppr (ValD binds) = ppr binds + ppr (DefD def) = ppr def + ppr (InstD inst) = ppr inst + ppr (ForD fd) = ppr fd + ppr (FixD fd) = ppr fd + ppr (RuleD rd) = ppr rd +\end{code} + + %************************************************************************ %* * \subsection[TyDecl]{@data@, @newtype@ or @type@ (synonym) type declaration} @@ -61,10 +110,11 @@ print_it sty suff prec var %************************************************************************ \begin{code} -data TyDecl name - = TyData (Context name) -- context +data TyClDecl name pat + = TyData NewOrData + (Context name) -- context name -- type constructor - [name] -- type variables + [HsTyVar name] -- type variables [ConDecl name] -- data constructors (empty if abstract) (Maybe [name]) -- derivings; Nothing => not specified -- (i.e., derive default); Just [] => derive @@ -73,56 +123,90 @@ data TyDecl name (DataPragmas name) SrcLoc - | TyNew (Context name) -- context - name -- type constructor - [name] -- type variables - [ConDecl name] -- data constructor (empty if abstract) - (Maybe [name]) -- derivings; as above - (DataPragmas name) + | TySynonym name -- type constructor + [HsTyVar name] -- type variables + (HsType name) -- synonym expansion SrcLoc - | TySynonym name -- type constructor - [name] -- type variables - (MonoType name) -- synonym expansion + | ClassDecl (Context name) -- context... + name -- name of the class + [HsTyVar name] -- the class type variables + [Sig name] -- methods' signatures + (MonoBinds name pat) -- default methods + (ClassPragmas name) + name name [name] -- The names of the tycon, datacon, and superclass selectors + -- for this class. These are filled in as the ClassDecl is made. SrcLoc +\end{code} + +\begin{code} +countTyClDecls :: [TyClDecl name pat] -> (Int, Int, Int, Int) + -- class, data, newtype, synonym decls +countTyClDecls decls + = (length [() | ClassDecl _ _ _ _ _ _ _ _ _ _ <- decls], + length [() | TyData DataType _ _ _ _ _ _ _ <- decls], + length [() | TyData NewType _ _ _ _ _ _ _ <- decls], + length [() | TySynonym _ _ _ _ <- decls]) + +isDataDecl, isSynDecl, isClassDecl :: TyClDecl name pat -> Bool +isSynDecl (TySynonym _ _ _ _) = True +isSynDecl other = False + +isDataDecl (TyData _ _ _ _ _ _ _ _) = True +isDataDecl other = False + +isClassDecl (ClassDecl _ _ _ _ _ _ _ _ _ _) = True +isClassDecl other = False \end{code} \begin{code} -instance (NamedThing name, Outputable name) - => Outputable (TyDecl name) where +instance (Outputable name, Outputable pat) + => Outputable (TyClDecl name pat) where - ppr sty (TySynonym tycon tyvars mono_ty src_loc) - = ppHang (pp_decl_head sty SLIT("type") ppNil tycon tyvars) - 4 (ppCat [ppEquals, ppr sty mono_ty]) + ppr (TySynonym tycon tyvars mono_ty src_loc) + = hang (pp_decl_head SLIT("type") empty tycon tyvars) + 4 (ppr mono_ty) - ppr sty (TyData context tycon tyvars condecls derivings pragmas src_loc) - = pp_tydecl sty - (pp_decl_head sty SLIT("data") (pprContext sty context) tycon tyvars) - (pp_condecls sty condecls) + ppr (TyData new_or_data context tycon tyvars condecls derivings pragmas src_loc) + = pp_tydecl + (pp_decl_head keyword (pprContext context) tycon tyvars) + (pp_condecls condecls) derivings + where + keyword = case new_or_data of + NewType -> SLIT("newtype") + DataType -> SLIT("data") + + ppr (ClassDecl context clas tyvars sigs methods pragmas _ _ _ src_loc) + | null sigs -- No "where" part + = top_matter + + | otherwise -- Laid out + = sep [hsep [top_matter, ptext SLIT("where {")], + nest 4 (vcat [sep (map ppr_sig sigs), + ppr methods, + char '}'])] + where + top_matter = hsep [ptext SLIT("class"), pprContext context, + ppr clas, hsep (map (ppr) tyvars)] + ppr_sig sig = ppr sig <> semi - ppr sty (TyNew context tycon tyvars condecl derivings pragmas src_loc) - = pp_tydecl sty - (pp_decl_head sty SLIT("newtype") (pprContext sty context) tycon tyvars) - (pp_condecls sty condecl) - derivings -pp_decl_head sty str pp_context tycon tyvars - = ppCat [ppPStr str, pp_context, ppr sty tycon, interppSP sty tyvars] +pp_decl_head str pp_context tycon tyvars + = hsep [ptext str, pp_context, ppr tycon, + interppSP tyvars, ptext SLIT("=")] -pp_condecls sty [] = ppNil -- abstract datatype -pp_condecls sty (c:cs) - = ppSep (ppBeside (ppStr "= ") (ppr sty c) - : map (\ x -> ppBeside (ppStr "| ") (ppr sty x)) cs) +pp_condecls [] = empty -- Curious! +pp_condecls (c:cs) = sep (ppr c : map (\ c -> ptext SLIT("|") <+> ppr c) cs) -pp_tydecl sty pp_head pp_decl_rhs derivings - = ppHang pp_head 4 (ppSep [ +pp_tydecl pp_head pp_decl_rhs derivings + = hang pp_head 4 (sep [ pp_decl_rhs, case derivings of - Nothing -> ppNil - Just ds -> ppBeside (ppPStr SLIT("deriving ")) - (ppParens (ppInterleave ppComma (map (ppr sty) ds)))]) + Nothing -> empty + Just ds -> hsep [ptext SLIT("deriving"), parens (interpp'SP ds)] + ]) \end{code} A type for recording what types a datatype should be specialised to. @@ -132,14 +216,14 @@ for an datatype declaration. \begin{code} data SpecDataSig name = SpecDataSig name -- tycon to specialise - (MonoType name) + (HsType name) SrcLoc -instance (NamedThing name, Outputable name) +instance (Outputable name) => Outputable (SpecDataSig name) where - ppr sty (SpecDataSig tycon ty _) - = ppCat [ppStr "{-# SPECIALIZE data", ppr sty ty, ppStr "#-}"] + ppr (SpecDataSig tycon ty _) + = hsep [text "{-# SPECIALIZE data", ppr ty, text "#-}"] \end{code} %************************************************************************ @@ -150,150 +234,103 @@ instance (NamedThing name, Outputable name) \begin{code} data ConDecl name - = ConDecl name -- prefix-style con decl - [BangType name] + = ConDecl name -- Constructor name + + [HsTyVar name] -- Existentially quantified type variables + (Context name) -- ...and context + -- If both are empty then there are no existentials + + (ConDetails name) SrcLoc - | ConOpDecl (BangType name) -- infix-style con decl - name +data ConDetails name + = VanillaCon -- prefix-style con decl + [BangType name] + + | InfixCon -- infix-style con decl + (BangType name) (BangType name) - SrcLoc - | RecConDecl name + | RecCon -- record-style con decl [([name], BangType name)] -- list of "fields" - SrcLoc - | NewConDecl name -- newtype con decl - (MonoType name) - SrcLoc + | NewCon -- newtype con decl, possibly with a labelled field. + (HsType name) + (Maybe name) -- Just x => labelled field 'x' data BangType name - = Banged (PolyType name) -- PolyType: to allow Haskell extensions - | Unbanged (PolyType name) -- (MonoType only needed for straight Haskell) -\end{code} - -\begin{code} -instance (NamedThing name, Outputable name) => Outputable (ConDecl name) where - - ppr sty (ConDecl con tys _) - = ppCat [pprNonSym sty con, ppInterleave ppNil (map (ppr_bang sty) tys)] - ppr sty (ConOpDecl ty1 op ty2 _) - = ppCat [ppr_bang sty ty1, pprSym sty op, ppr_bang sty ty2] - ppr sty (NewConDecl con ty _) - = ppCat [pprNonSym sty con, pprParendMonoType sty ty] - ppr sty (RecConDecl con fields _) - = ppCat [pprNonSym sty con, ppChar '{', - ppInterleave pp'SP (map pp_field fields), ppChar '}'] - where - pp_field (n, ty) = ppCat [ppr sty n, ppPStr SLIT("::"), ppr_bang sty ty] - -ppr_bang sty (Banged ty) = ppBeside (ppChar '!') (pprParendPolyType sty ty) -ppr_bang sty (Unbanged ty) = pprParendPolyType sty ty + = Banged (HsType name) -- HsType: to allow Haskell extensions + | Unbanged (HsType name) -- (MonoType only needed for straight Haskell) + | Unpacked (HsType name) -- Field is strict and to be unpacked if poss. \end{code} -%************************************************************************ -%* * -\subsection[ClassDecl]{A class declaration} -%* * -%************************************************************************ - \begin{code} -data ClassDecl tyvar uvar name pat - = ClassDecl (Context name) -- context... - name -- name of the class - name -- the class type variable - [Sig name] -- methods' signatures - (MonoBinds tyvar uvar name pat) -- default methods - (ClassPragmas name) - SrcLoc +instance (Outputable name) => Outputable (ConDecl name) where + ppr (ConDecl con tvs cxt con_details loc) + = sep [pprForAll tvs, pprContext cxt, ppr_con_details con con_details] + +ppr_con_details con (InfixCon ty1 ty2) + = hsep [ppr_bang ty1, ppr con, ppr_bang ty2] + +ppr_con_details con (VanillaCon tys) + = ppr con <+> hsep (map (ppr_bang) tys) + +ppr_con_details con (NewCon ty Nothing) + = ppr con <+> pprParendHsType ty + +ppr_con_details con (NewCon ty (Just x)) + = ppr con <+> braces pp_field + where + pp_field = ppr x <+> dcolon <+> pprParendHsType ty + +ppr_con_details con (RecCon fields) + = ppr con <+> braces (hsep (punctuate comma (map ppr_field fields))) + where + ppr_field (ns, ty) = hsep (map (ppr) ns) <+> + dcolon <+> + ppr_bang ty + +ppr_bang (Banged ty) = ptext SLIT("!") <> pprParendHsType ty +ppr_bang (Unbanged ty) = pprParendHsType ty +ppr_bang (Unpacked ty) = ptext SLIT("! !") <> pprParendHsType ty \end{code} -\begin{code} -instance (NamedThing name, Outputable name, Outputable pat, - Eq tyvar, Outputable tyvar, Eq uvar, Outputable uvar) - => Outputable (ClassDecl tyvar uvar name pat) where - - ppr sty (ClassDecl context clas tyvar sigs methods pragmas src_loc) - = let - top_matter = ppCat [ppStr "class", pprContext sty context, - ppr sty clas, ppr sty tyvar] - in - if null sigs && nullMonoBinds methods then - ppAbove top_matter (ppNest 4 (ppr sty pragmas)) - else - ppAboves [ppCat [top_matter, ppStr "where"], - ppNest 4 (ppAboves (map (ppr sty) sigs)), - ppNest 4 (ppr sty methods), - ppNest 4 (ppr sty pragmas) ] -\end{code} %************************************************************************ %* * -\subsection[InstDecl]{An instance declaration (also, @SpecInstSig@)} +\subsection[InstDecl]{An instance declaration %* * %************************************************************************ \begin{code} -data InstDecl tyvar uvar name pat - = InstDecl name -- Class - - (PolyType name) -- Context => Instance-type +data InstDecl name pat + = InstDecl (HsType name) -- Context => Class Instance-type -- Using a polytype means that the renamer conveniently -- figures out the quantified type variables for us. - (MonoBinds tyvar uvar name pat) + (MonoBinds name pat) - Bool -- True <=> This instance decl is from the - -- module being compiled; False <=> It is from - -- an imported interface. + [Sig name] -- User-supplied pragmatic info - (Maybe Module) -- The name of the module where the instance decl - -- originally came from; Nothing => Prelude + name -- Name for the dictionary function - [Sig name] -- actually user-supplied pragmatic info - (InstancePragmas name) -- interface-supplied pragmatic info SrcLoc \end{code} \begin{code} -instance (NamedThing name, Outputable name, Outputable pat, - Eq tyvar, Outputable tyvar, Eq uvar, Outputable uvar) - => Outputable (InstDecl tyvar uvar name pat) where - - ppr sty (InstDecl clas ty binds local modname uprags pragmas src_loc) - = let - (context, inst_ty) - = case ty of - HsPreForAllTy c t -> (c, t) - HsForAllTy _ c t -> (c, t) - - top_matter = ppCat [ppStr "instance", pprContext sty context, - ppr sty clas, pprParendMonoType sty inst_ty] - in - if nullMonoBinds binds && null uprags then - ppAbove top_matter (ppNest 4 (ppr sty pragmas)) +instance (Outputable name, Outputable pat) + => Outputable (InstDecl name pat) where + + ppr (InstDecl inst_ty binds uprags dfun_name src_loc) + = getPprStyle $ \ sty -> + if ifaceStyle sty || (nullMonoBinds binds && null uprags) then + hsep [ptext SLIT("instance"), ppr inst_ty] else - ppAboves [ppCat [top_matter, ppStr "where"], - if null uprags then ppNil else ppNest 4 (ppr sty uprags), - ppNest 4 (ppr sty binds), - ppNest 4 (ppr sty pragmas) ] + vcat [hsep [ptext SLIT("instance"), ppr inst_ty, ptext SLIT("where")], + nest 4 (ppr uprags), + nest 4 (ppr binds) ] \end{code} -A type for recording what instances the user wants to specialise; -called a ``Sig'' because it's sort of like a ``type signature'' for an -instance. -\begin{code} -data SpecInstSig name - = SpecInstSig name -- class - (MonoType name) -- type to specialise to - SrcLoc - -instance (NamedThing name, Outputable name) - => Outputable (SpecInstSig name) where - - ppr sty (SpecInstSig clas ty _) - = ppCat [ppStr "{-# SPECIALIZE instance", ppr sty clas, ppr sty ty, ppStr "#-}"] -\end{code} %************************************************************************ %* * @@ -307,12 +344,108 @@ syntax, and that restriction must be checked in the front end. \begin{code} data DefaultDecl name - = DefaultDecl [MonoType name] + = DefaultDecl [HsType name] SrcLoc -instance (NamedThing name, Outputable name) +instance (Outputable name) => Outputable (DefaultDecl name) where - ppr sty (DefaultDecl tys src_loc) - = ppBeside (ppPStr SLIT("default ")) (ppParens (interpp'SP sty tys)) + ppr (DefaultDecl tys src_loc) + = ptext SLIT("default") <+> parens (interpp'SP tys) +\end{code} + +%************************************************************************ +%* * +\subsection{Foreign function interface declaration} +%* * +%************************************************************************ + +\begin{code} +data ForeignDecl name = + ForeignDecl + name + ForKind + (HsType name) + ExtName + CallConv + SrcLoc + +instance (Outputable name) + => Outputable (ForeignDecl name) where + + ppr (ForeignDecl nm imp_exp ty ext_name cconv src_loc) + = ptext SLIT("foreign") <+> ppr_imp_exp <+> pprCallConv cconv <+> + ppr ext_name <+> ppr_unsafe <+> ppr nm <+> dcolon <+> ppr ty + where + (ppr_imp_exp, ppr_unsafe) = + case imp_exp of + FoLabel -> (ptext SLIT("label"), empty) + FoExport -> (ptext SLIT("export"), empty) + FoImport us + | us -> (ptext SLIT("import"), ptext SLIT("unsafe")) + | otherwise -> (ptext SLIT("import"), empty) + +data ForKind + = FoLabel + | FoExport + | FoImport Bool -- True => unsafe call. + +data ExtName + = Dynamic + | ExtName FAST_STRING (Maybe FAST_STRING) + +isDynamic :: ExtName -> Bool +isDynamic Dynamic = True +isDynamic _ = False + + +instance Outputable ExtName where + ppr Dynamic = ptext SLIT("dynamic") + ppr (ExtName nm mb_mod) = + case mb_mod of { Nothing -> empty; Just m -> doubleQuotes (ptext m) } <+> + doubleQuotes (ptext nm) + +\end{code} + +%************************************************************************ +%* * +\subsection{Transformation rules} +%* * +%************************************************************************ + +\begin{code} +data RuleDecl name pat + = RuleDecl + FAST_STRING -- Rule name + [name] -- Forall'd tyvars, filled in by the renamer with + -- tyvars mentioned in sigs; then filled out by typechecker + [RuleBndr name] -- Forall'd term vars + (HsExpr name pat) -- LHS + (HsExpr name pat) -- RHS + SrcLoc + + | IfaceRuleDecl -- One that's come in from an interface file + name + (UfRuleBody name) + SrcLoc + +data RuleBndr name + = RuleBndr name + | RuleBndrSig name (HsType name) + +instance (Outputable name, Outputable pat) + => Outputable (RuleDecl name pat) where + ppr (RuleDecl name tvs ns lhs rhs loc) + = text "RULE" <+> doubleQuotes (ptext name) <> colon <+> + sep [pp_forall, ppr lhs, equals <+> ppr rhs] + where + pp_forall | null tvs && null ns = empty + | otherwise = text "forall" <+> + fsep (map ppr tvs ++ map ppr ns) + <> dot + ppr (IfaceRuleDecl var body loc) = text "An imported rule..." + +instance Outputable name => Outputable (RuleBndr name) where + ppr (RuleBndr name) = ppr name + ppr (RuleBndrSig name ty) = ppr name <> dcolon <> ppr ty \end{code}