:: a typeCtrl KGHC 9.14.1 · lts/ghc-9.14.x · b2f3bfd · 2026-10-11
Moduleghc-9.14.1GHC2021
This module provides the generated Happy parser for Haskell. It exports a number of parsers which may be used in any library that uses the GHC API. A common usage pattern is to initialize the parser state with a given string and then parse that string:
runParser :: ParserOpts -> String -> P a -> ParseResult a
runParser opts str parser = unP parser parseState
where
filename = "<interactive>"
location = mkRealSrcLoc (mkFastString filename) 1 1
buffer = stringToStringBuffer str
parseState = initParserState opts buffer location
Parse a Haskell module with Haddock comments. This is done in two steps:
parseModuleNoHaddock to build the AST
addHaddockToModule to insert Haddock comments into it
This and the signature module parser are the only parser entry points that deal with Haddock comments. The other entry points (parseDeclaration, parseExpression, etc) do not insert them into the AST.
Parse a Haskell signature module with Haddock comments. This is done in two steps:
parseSignatureNoHaddock to build the AST
addHaddockToModule to insert Haddock comments into it
This and the module parser are the only parser entry points that deal with Haddock comments. The other entry points (parseDeclaration, parseExpression, etc) do not insert them into the AST.
parseStatement :: P (GenLocated SrcSpanAnnA (StmtLR GhcPs GhcPs (GenLocated SrcSpanAnnA (HsExpr GhcPs))))parseStmt :: P (Maybe (GenLocated SrcSpanAnnA (StmtLR GhcPs GhcPs (GenLocated SrcSpanAnnA (HsExpr GhcPs)))))