/usr/share/doc/libghc-polyparse-doc/html/src/Text-ParserCombinators-Poly-State.html is in libghc-polyparse-doc 1.7-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<!-- Generated by HsColour, http://code.haskell.org/~malcolm/hscolour/ -->
<title>src/Text/ParserCombinators/Poly/State.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>ParserCombinators</span><span class='hs-varop'>.</span><span class='hs-conid'>Poly</span><span class='hs-varop'>.</span><span class='hs-conid'>State</span>
<a name="line-2"></a> <span class='hs-layout'>(</span> <span class='hs-comment'>-- * The Parser datatype</span>
<a name="line-3"></a> <span class='hs-conid'>Parser</span><span class='hs-layout'>(</span><span class='hs-conid'>P</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- datatype, instance of: Functor, Monad, PolyParse</span>
<a name="line-4"></a> <span class='hs-layout'>,</span> <span class='hs-conid'>Result</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- internal to the parser monad</span>
<a name="line-5"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>runParser</span> <span class='hs-comment'>-- :: Parser s t a -> s -> [t] -> (Either String a, s, [t])</span>
<a name="line-6"></a> <span class='hs-comment'>-- ** Basic parsers</span>
<a name="line-7"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>next</span> <span class='hs-comment'>-- :: Parser s t t</span>
<a name="line-8"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>eof</span> <span class='hs-comment'>-- :: Parser s t ()</span>
<a name="line-9"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>satisfy</span> <span class='hs-comment'>-- :: (t->Bool) -> Parser s t t</span>
<a name="line-10"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>onFail</span> <span class='hs-comment'>-- :: Parser s t a -> Parser s t a -> Parser s t a</span>
<a name="line-11"></a> <span class='hs-comment'>-- ** State-handling</span>
<a name="line-12"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stUpdate</span> <span class='hs-comment'>-- :: (s->s) -> Parser s t ()</span>
<a name="line-13"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stQuery</span> <span class='hs-comment'>-- :: (s->a) -> Parser s t a</span>
<a name="line-14"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>stGet</span> <span class='hs-comment'>-- :: Parser s t s</span>
<a name="line-15"></a> <span class='hs-comment'>-- ** Re-parsing</span>
<a name="line-16"></a> <span class='hs-layout'>,</span> <span class='hs-varid'>reparse</span> <span class='hs-comment'>-- :: [t] -> Parser s t ()</span>
<a name="line-17"></a> <span class='hs-comment'>-- * Re-export all more general combinators</span>
<a name="line-18"></a> <span class='hs-layout'>,</span> <span class='hs-keyword'>module</span> <span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>ParserCombinators</span><span class='hs-varop'>.</span><span class='hs-conid'>Poly</span><span class='hs-varop'>.</span><span class='hs-conid'>Base</span>
<a name="line-19"></a> <span class='hs-layout'>,</span> <span class='hs-keyword'>module</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Applicative</span>
<a name="line-20"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-21"></a>
<a name="line-22"></a>
<a name="line-23"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>ParserCombinators</span><span class='hs-varop'>.</span><span class='hs-conid'>Poly</span><span class='hs-varop'>.</span><span class='hs-conid'>Base</span>
<a name="line-24"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>ParserCombinators</span><span class='hs-varop'>.</span><span class='hs-conid'>Poly</span><span class='hs-varop'>.</span><span class='hs-conid'>Result</span>
<a name="line-25"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Text</span><span class='hs-varop'>.</span><span class='hs-conid'>ParserCombinators</span><span class='hs-varop'>.</span><span class='hs-conid'>Poly</span><span class='hs-varop'>.</span><span class='hs-conid'>StateParser</span>
<a name="line-26"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Applicative</span>
<a name="line-27"></a>
<a name="line-28"></a><span class='hs-comment'>-- The only differences between a State and a StateLazy parser are the instance</span>
<a name="line-29"></a><span class='hs-comment'>-- of Applicative, and the type (and implementation) of runParser.</span>
<a name="line-30"></a>
<a name="line-31"></a><a name="runParser"></a><span class='hs-comment'>-- | Apply a parser to an input token sequence.</span>
<a name="line-32"></a><span class='hs-definition'>runParser</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Parser</span> <span class='hs-varid'>s</span> <span class='hs-varid'>t</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>s</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>t</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-layout'>(</span><span class='hs-conid'>Either</span> <span class='hs-conid'>String</span> <span class='hs-varid'>a</span><span class='hs-layout'>,</span> <span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>t</span><span class='hs-keyglyph'>]</span><span class='hs-layout'>)</span>
<a name="line-33"></a><span class='hs-definition'>runParser</span> <span class='hs-layout'>(</span><span class='hs-conid'>P</span> <span class='hs-varid'>p</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>s</span><span class='hs-keyglyph'>-></span> <span class='hs-varid'>reTuple</span> <span class='hs-varop'>.</span> <span class='hs-varid'>resultToEither</span> <span class='hs-varop'>.</span> <span class='hs-varid'>p</span> <span class='hs-varid'>s</span>
<a name="line-34"></a> <span class='hs-keyword'>where</span>
<a name="line-35"></a> <span class='hs-varid'>reTuple</span> <span class='hs-layout'>(</span><span class='hs-varid'>either</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varid'>z</span><span class='hs-layout'>,</span><span class='hs-varid'>s</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-layout'>(</span><span class='hs-varid'>either</span><span class='hs-layout'>,</span> <span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-varid'>z</span><span class='hs-layout'>)</span>
<a name="line-36"></a>
<a name="line-37"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Applicative</span> <span class='hs-layout'>(</span><span class='hs-conid'>Parser</span> <span class='hs-varid'>s</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-38"></a> <span class='hs-varid'>pure</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varid'>f</span>
<a name="line-39"></a> <span class='hs-varid'>pf</span> <span class='hs-varop'><*></span> <span class='hs-varid'>px</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-layout'>{</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>pf</span><span class='hs-layout'>;</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>px</span><span class='hs-layout'>;</span> <span class='hs-varid'>return</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>}</span>
<a name="line-40"></a><span class='hs-cpp'>#if defined(GLASGOW_HASKELL) && GLASGOW_HASKELL > 610</span>
<a name="line-41"></a> <span class='hs-varid'>p</span> <span class='hs-varop'><*</span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>p</span> <span class='hs-varop'>`discard`</span> <span class='hs-varid'>q</span>
<a name="line-42"></a><span class='hs-cpp'>#endif</span>
<a name="line-43"></a>
<a name="line-44"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Alternative</span> <span class='hs-layout'>(</span><span class='hs-conid'>Parser</span> <span class='hs-varid'>s</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-45"></a> <span class='hs-varid'>empty</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fail</span> <span class='hs-str'>"no parse"</span>
<a name="line-46"></a> <span class='hs-varid'>p</span> <span class='hs-varop'><|></span> <span class='hs-varid'>q</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>p</span> <span class='hs-varop'>`onFail`</span> <span class='hs-varid'>q</span>
<a name="line-47"></a>
<a name="line-48"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>PolyParse</span> <span class='hs-layout'>(</span><span class='hs-conid'>Parser</span> <span class='hs-varid'>s</span> <span class='hs-varid'>t</span><span class='hs-layout'>)</span>
<a name="line-49"></a>
<a name="line-50"></a><span class='hs-comment'>------------------------------------------------------------------------</span>
</pre></body>
</html>
|