<?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>System/Console/CmdArgs/Annotate.hs</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='hs-comment'>{-# LANGUAGE PatternGuards, ScopedTypeVariables, ExistentialQuantification, DeriveDataTypeable #-}</span>
<a name="line-2"></a>
<a name="line-3"></a><span class='hs-comment'>-- | This module captures annotations on a value, and builds a 'Capture' value.</span>
<a name="line-4"></a><span class='hs-comment'>-- This module has two ways of writing annotations:</span>
<a name="line-5"></a><span class='hs-comment'>--</span>
<a name="line-6"></a><span class='hs-comment'>-- /Impure/: The impure method of writing annotations is susceptible to over-optimisation by GHC</span>
<a name="line-7"></a><span class='hs-comment'>-- - sometimes @\{\-\# OPTIONS_GHC -fno-cse \#\-\}@ will be required.</span>
<a name="line-8"></a><span class='hs-comment'>--</span>
<a name="line-9"></a><span class='hs-comment'>-- /Pure/: The pure method is more verbose, and lacks some type safety.</span>
<a name="line-10"></a><span class='hs-comment'>--</span>
<a name="line-11"></a><span class='hs-comment'>-- As an example of the two styles:</span>
<a name="line-12"></a><span class='hs-comment'>--</span>
<a name="line-13"></a><span class='hs-comment'>-- > data Foo = Foo {foo :: Int, bar :: Int}</span>
<a name="line-14"></a><span class='hs-comment'>--</span>
<a name="line-15"></a><span class='hs-comment'>-- @ impure = 'capture' $ Foo {foo = 12, bar = 'many' [1 '&=' \"inner\", 2]} '&=' \"top\"@</span>
<a name="line-16"></a><span class='hs-comment'>--</span>
<a name="line-17"></a><span class='hs-comment'>-- @ pure = 'capture_' $ 'record' Foo{} [foo := 12, bar :=+ ['atom' 1 '+=' \"inner\", 'atom' 2]] '+=' \"top\"@</span>
<a name="line-18"></a><span class='hs-comment'>--</span>
<a name="line-19"></a><span class='hs-comment'>-- Both evaluate to:</span>
<a name="line-20"></a><span class='hs-comment'>--</span>
<a name="line-21"></a><span class='hs-comment'>-- > Capture (Ann "top") (Ctor (Foo 12 1) [Value 12, Many [Ann "inner" (Value 1), Value 2]]</span>
<a name="line-22"></a><span class='hs-keyword'>module</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>Console</span><span class='hs-varop'>.</span><span class='hs-conid'>CmdArgs</span><span class='hs-varop'>.</span><span class='hs-conid'>Annotate</span><span class='hs-layout'>(</span>
<a name="line-23"></a> <span class='hs-comment'>-- * Capture framework</span>
<a name="line-24"></a> <span class='hs-conid'>Capture</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-conid'>Any</span><span class='hs-layout'>(</span><span class='hs-keyglyph'>..</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>fromCapture</span><span class='hs-layout'>,</span> <span class='hs-varid'>defaultMissing</span><span class='hs-layout'>,</span>
<a name="line-25"></a> <span class='hs-comment'>-- * Impure</span>
<a name="line-26"></a> <span class='hs-varid'>capture</span><span class='hs-layout'>,</span> <span class='hs-varid'>many</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>&=</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span>
<a name="line-27"></a> <span class='hs-comment'>-- * Pure</span>
<a name="line-28"></a> <span class='hs-varid'>capture_</span><span class='hs-layout'>,</span> <span class='hs-varid'>many_</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varop'>+=</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span> <span class='hs-varid'>atom</span><span class='hs-layout'>,</span> <span class='hs-varid'>record</span><span class='hs-layout'>,</span> <span class='hs-conid'>Annotate</span><span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-conop'>:=</span><span class='hs-layout'>)</span><span class='hs-layout'>,</span><span class='hs-layout'>(</span><span class='hs-conop'>:=+</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span>
<a name="line-29"></a> <span class='hs-layout'>)</span> <span class='hs-keyword'>where</span>
<a name="line-30"></a>
<a name="line-31"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span>
<a name="line-32"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Monad</span><span class='hs-varop'>.</span><span class='hs-conid'>Trans</span><span class='hs-varop'>.</span><span class='hs-conid'>State</span>
<a name="line-33"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Data</span><span class='hs-layout'>(</span><span class='hs-conid'>Data</span><span class='hs-layout'>,</span><span class='hs-conid'>Typeable</span><span class='hs-layout'>)</span>
<a name="line-34"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>List</span>
<a name="line-35"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Maybe</span>
<a name="line-36"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>IORef</span>
<a name="line-37"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>System</span><span class='hs-varop'>.</span><span class='hs-conid'>IO</span><span class='hs-varop'>.</span><span class='hs-conid'>Unsafe</span>
<a name="line-38"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Control</span><span class='hs-varop'>.</span><span class='hs-conid'>Exception</span>
<a name="line-39"></a><span class='hs-keyword'>import</span> <span class='hs-conid'>Data</span><span class='hs-varop'>.</span><span class='hs-conid'>Generics</span><span class='hs-varop'>.</span><span class='hs-conid'>Any</span>
<a name="line-40"></a>
<a name="line-41"></a><span class='hs-keyword'>infixl</span> <span class='hs-num'>2</span> <span class='hs-varop'>&=</span><span class='hs-layout'>,</span> <span class='hs-varop'>+=</span>
<a name="line-42"></a><span class='hs-keyword'>infix</span> <span class='hs-num'>3</span> <span class='hs-conop'>:=</span>
<a name="line-43"></a>
<a name="line-44"></a>
<a name="line-45"></a><a name="Capture"></a><span class='hs-comment'>-- | The result of capturing some annotations.</span>
<a name="line-46"></a><a name="Capture"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span>
<a name="line-47"></a> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Many</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ Many values collapsed ('many' or 'many_')</span>
<a name="line-48"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Ann</span> <span class='hs-varid'>ann</span> <span class='hs-layout'>(</span><span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span><span class='hs-layout'>)</span> <span class='hs-comment'>-- ^ An annotation attached to a value ('&=' or '+=')</span>
<a name="line-49"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Value</span> <span class='hs-conid'>Any</span> <span class='hs-comment'>-- ^ A value (just a value, or 'atom')</span>
<a name="line-50"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Missing</span> <span class='hs-conid'>Any</span> <span class='hs-comment'>-- ^ A missing field (a 'RecConError' exception, or missing from 'record')</span>
<a name="line-51"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Ctor</span> <span class='hs-conid'>Any</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ A constructor (a constructor, or 'record')</span>
<a name="line-52"></a> <span class='hs-keyword'>deriving</span> <span class='hs-conid'>Show</span>
<a name="line-53"></a>
<a name="line-54"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Functor</span> <span class='hs-conid'>Capture</span> <span class='hs-keyword'>where</span>
<a name="line-55"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Many</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Many</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-56"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ann</span> <span class='hs-varid'>a</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Ann</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span>
<a name="line-57"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Value</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Value</span> <span class='hs-varid'>x</span>
<a name="line-58"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Missing</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Missing</span> <span class='hs-varid'>x</span>
<a name="line-59"></a> <span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-60"></a>
<a name="line-61"></a>
<a name="line-62"></a><a name="fromCapture"></a><span class='hs-comment'>-- | Return the value inside a capture.</span>
<a name="line-63"></a><span class='hs-definition'>fromCapture</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Any</span>
<a name="line-64"></a><span class='hs-definition'>fromCapture</span> <span class='hs-layout'>(</span><span class='hs-conid'>Many</span> <span class='hs-layout'>(</span><span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-keyword'>_</span><span class='hs-layout'>)</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fromCapture</span> <span class='hs-varid'>x</span>
<a name="line-65"></a><span class='hs-definition'>fromCapture</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ann</span> <span class='hs-keyword'>_</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fromCapture</span> <span class='hs-varid'>x</span>
<a name="line-66"></a><span class='hs-definition'>fromCapture</span> <span class='hs-layout'>(</span><span class='hs-conid'>Value</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span>
<a name="line-67"></a><span class='hs-definition'>fromCapture</span> <span class='hs-layout'>(</span><span class='hs-conid'>Missing</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span>
<a name="line-68"></a><span class='hs-definition'>fromCapture</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>x</span>
<a name="line-69"></a>
<a name="line-70"></a>
<a name="line-71"></a><a name="defaultMissing"></a><span class='hs-comment'>-- | Remove all Missing values by using any previous instances as default values</span>
<a name="line-72"></a><span class='hs-definition'>defaultMissing</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span>
<a name="line-73"></a><span class='hs-definition'>defaultMissing</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>evalState</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-conid'>Nothing</span> <span class='hs-conid'>Nothing</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-conid'>[]</span>
<a name="line-74"></a> <span class='hs-keyword'>where</span>
<a name="line-75"></a> <span class='hs-varid'>f</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>field</span> <span class='hs-layout'>(</span><span class='hs-conid'>Many</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fmap</span> <span class='hs-conid'>Many</span> <span class='hs-varop'>$</span> <span class='hs-varid'>mapM</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>field</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-76"></a> <span class='hs-varid'>f</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>field</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ann</span> <span class='hs-varid'>a</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fmap</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ann</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>f</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>field</span> <span class='hs-varid'>x</span>
<a name="line-77"></a> <span class='hs-varid'>f</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>field</span> <span class='hs-layout'>(</span><span class='hs-conid'>Value</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Value</span> <span class='hs-varid'>x</span>
<a name="line-78"></a> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>ctor</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>field</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Missing</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-79"></a> <span class='hs-varid'>s</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>get</span>
<a name="line-80"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>head</span> <span class='hs-varop'>$</span>
<a name="line-81"></a> <span class='hs-keyglyph'>[</span><span class='hs-varid'>x2</span> <span class='hs-keyglyph'>|</span> <span class='hs-layout'>(</span><span class='hs-varid'>ctor2</span><span class='hs-layout'>,</span><span class='hs-varid'>field2</span><span class='hs-layout'>,</span><span class='hs-varid'>x2</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>s</span><span class='hs-layout'>,</span> <span class='hs-varid'>typeOf</span> <span class='hs-varid'>ctor</span> <span class='hs-varop'>==</span> <span class='hs-varid'>typeOf</span> <span class='hs-varid'>ctor2</span><span class='hs-layout'>,</span> <span class='hs-varid'>field</span> <span class='hs-varop'>==</span> <span class='hs-varid'>field2</span><span class='hs-keyglyph'>]</span> <span class='hs-varop'>++</span>
<a name="line-82"></a> <span class='hs-varid'>err</span> <span class='hs-layout'>(</span><span class='hs-str'>"missing value encountered, no field for "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>field</span> <span class='hs-varop'>++</span> <span class='hs-str'>" (of type "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>x</span> <span class='hs-varop'>++</span> <span class='hs-str'>")"</span><span class='hs-layout'>)</span>
<a name="line-83"></a> <span class='hs-varid'>f</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Missing</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>err</span> <span class='hs-varop'>$</span> <span class='hs-str'>"missing value encountered, but not as a field (of type "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>x</span> <span class='hs-varop'>++</span> <span class='hs-str'>")"</span>
<a name="line-84"></a> <span class='hs-varid'>f</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>length</span> <span class='hs-layout'>(</span><span class='hs-varid'>fields</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varop'>==</span> <span class='hs-varid'>length</span> <span class='hs-varid'>xs</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-85"></a> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>zipWithM</span> <span class='hs-layout'>(</span><span class='hs-varid'>g</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>fields</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-86"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Ctor</span> <span class='hs-layout'>(</span><span class='hs-varid'>recompose</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-varid'>fromCapture</span> <span class='hs-varid'>ys</span><span class='hs-layout'>)</span> <span class='hs-varid'>ys</span>
<a name="line-87"></a> <span class='hs-varid'>f</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fmap</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>mapM</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-conid'>Nothing</span> <span class='hs-conid'>Nothing</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-88"></a>
<a name="line-89"></a> <span class='hs-varid'>g</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>field</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-90"></a> <span class='hs-varid'>y</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>f</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>ctor</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Just</span> <span class='hs-varid'>field</span><span class='hs-layout'>)</span> <span class='hs-varid'>x</span>
<a name="line-91"></a> <span class='hs-varid'>modify</span> <span class='hs-layout'>(</span><span class='hs-layout'>(</span><span class='hs-varid'>ctor</span><span class='hs-layout'>,</span><span class='hs-varid'>field</span><span class='hs-layout'>,</span><span class='hs-varid'>y</span><span class='hs-layout'>)</span><span class='hs-conop'>:</span><span class='hs-layout'>)</span>
<a name="line-92"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>y</span>
<a name="line-93"></a>
<a name="line-94"></a> <span class='hs-varid'>err</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-varop'>$</span> <span class='hs-str'>"System.Console.CmdArgs.Annotate.defaultMissing, "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>x</span>
<a name="line-95"></a>
<a name="line-96"></a><span class='hs-comment'>---------------------------------------------------------------------</span>
<a name="line-97"></a><span class='hs-comment'>-- IMPURE BIT</span>
<a name="line-98"></a>
<a name="line-99"></a><span class='hs-comment'>-- test = show $ capture $ many [Just ((66::Int) &= P 1 &= P 2), Nothing &= P 8] &= P 3</span>
<a name="line-100"></a>
<a name="line-101"></a><span class='hs-comment'>{-
<a name="line-102"></a>Notes On Purity
<a name="line-103"></a>---------------
<a name="line-104"></a>
<a name="line-105"></a>There is a risk that things that are unsafe will be inlined. That can generally be
<a name="line-106"></a>removed by NOININE on everything.
<a name="line-107"></a>
<a name="line-108"></a>There is also a risk that things get commoned up. For example:
<a name="line-109"></a>
<a name="line-110"></a>foo = trace "1" 1
<a name="line-111"></a>bar = trace "1" 1
<a name="line-112"></a>main = do
<a name="line-113"></a> evaluate foo
<a name="line-114"></a> evaluate bar
<a name="line-115"></a>
<a name="line-116"></a>Will print "1" only once, since foo and bar share the same pattern. However, if
<a name="line-117"></a>anything in the value is a lambda they are not seen as equal. We exploit this by
<a name="line-118"></a>defining const_ and id_ as per this module.
<a name="line-119"></a>
<a name="line-120"></a>Now anything wrapped in id_ looks different from anything else.
<a name="line-121"></a>-}</span>
<a name="line-122"></a>
<a name="line-123"></a>
<a name="line-124"></a><span class='hs-comment'>{-
<a name="line-125"></a>The idea is to keep a stack of either continuations, or values
<a name="line-126"></a>If you encounter 'many' you become a value
<a name="line-127"></a>If you encounter '&=' you increase the continuation
<a name="line-128"></a>-}</span>
<a name="line-129"></a>
<a name="line-130"></a><a name="ref"></a><span class='hs-comment'>{-# NOINLINE ref #-}</span>
<a name="line-131"></a><span class='hs-definition'>ref</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>IORef</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Either</span> <span class='hs-layout'>(</span><span class='hs-conid'>Capture</span> <span class='hs-conid'>Any</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Capture</span> <span class='hs-conid'>Any</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-conid'>Capture</span> <span class='hs-conid'>Any</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-132"></a><span class='hs-definition'>ref</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>newIORef</span> <span class='hs-conid'>[]</span>
<a name="line-133"></a>
<a name="line-134"></a><a name="push"></a><span class='hs-definition'>push</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>modifyIORef</span> <span class='hs-varid'>ref</span> <span class='hs-layout'>(</span><span class='hs-conid'>Left</span> <span class='hs-varid'>id</span> <span class='hs-conop'>:</span><span class='hs-layout'>)</span>
<a name="line-135"></a><a name="pop"></a><span class='hs-definition'>pop</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span> <span class='hs-varid'>x</span><span class='hs-conop'>:</span><span class='hs-varid'>xs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>readIORef</span> <span class='hs-varid'>ref</span><span class='hs-layout'>;</span> <span class='hs-varid'>writeIORef</span> <span class='hs-varid'>ref</span> <span class='hs-varid'>xs</span><span class='hs-layout'>;</span> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-136"></a><a name="change"></a><span class='hs-definition'>change</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>modifyIORef</span> <span class='hs-varid'>ref</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>case</span> <span class='hs-varid'>x</span> <span class='hs-keyword'>of</span> <span class='hs-conid'>Left</span> <span class='hs-varid'>g</span> <span class='hs-conop'>:</span> <span class='hs-varid'>rest</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span> <span class='hs-varid'>g</span> <span class='hs-conop'>:</span> <span class='hs-varid'>rest</span> <span class='hs-layout'>;</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>error</span> <span class='hs-str'>"Internal error in Capture"</span>
<a name="line-137"></a><a name="add"></a><span class='hs-definition'>add</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>change</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Left</span> <span class='hs-varop'>$</span> <span class='hs-varid'>x</span> <span class='hs-varop'>.</span> <span class='hs-varid'>f</span>
<a name="line-138"></a><a name="set"></a><span class='hs-definition'>set</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>change</span> <span class='hs-varop'>$</span> <span class='hs-keyglyph'>\</span><span class='hs-varid'>f</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Right</span> <span class='hs-varop'>$</span> <span class='hs-varid'>f</span> <span class='hs-varid'>x</span>
<a name="line-139"></a>
<a name="line-140"></a>
<a name="line-141"></a><a name="many"></a><span class='hs-comment'>-- | Collapse multiple values in to one.</span>
<a name="line-142"></a><span class='hs-comment'>{-# NOINLINE many #-}</span>
<a name="line-143"></a><span class='hs-definition'>many</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>val</span> <span class='hs-keyglyph'>=></span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>val</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>val</span>
<a name="line-144"></a><span class='hs-definition'>many</span> <span class='hs-varid'>xs</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-145"></a> <span class='hs-varid'>ys</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>mapM</span> <span class='hs-layout'>(</span><span class='hs-varid'>force</span> <span class='hs-varop'>.</span> <span class='hs-conid'>Any</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-146"></a> <span class='hs-varid'>set</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Many</span> <span class='hs-varid'>ys</span>
<a name="line-147"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>head</span> <span class='hs-varid'>xs</span>
<a name="line-148"></a>
<a name="line-149"></a>
<a name="line-150"></a><a name="addAnn"></a><span class='hs-comment'>{-# NOINLINE addAnn #-}</span>
<a name="line-151"></a><span class='hs-definition'>addAnn</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Data</span> <span class='hs-varid'>val</span><span class='hs-layout'>,</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>ann</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>val</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>ann</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>val</span>
<a name="line-152"></a><span class='hs-definition'>addAnn</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-153"></a> <span class='hs-varid'>add</span> <span class='hs-layout'>(</span><span class='hs-conid'>Ann</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Any</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-154"></a> <span class='hs-varid'>evaluate</span> <span class='hs-varid'>x</span>
<a name="line-155"></a> <span class='hs-varid'>return</span> <span class='hs-varid'>x</span>
<a name="line-156"></a>
<a name="line-157"></a>
<a name="line-158"></a><a name="capture"></a><span class='hs-comment'>-- | Capture a value. Note that if the value is evaluated</span>
<a name="line-159"></a><span class='hs-comment'>-- more than once the result may be different, i.e.</span>
<a name="line-160"></a><span class='hs-comment'>--</span>
<a name="line-161"></a><span class='hs-comment'>-- > capture x /= capture x</span>
<a name="line-162"></a><span class='hs-comment'>{-# NOINLINE capture #-}</span>
<a name="line-163"></a><span class='hs-definition'>capture</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Data</span> <span class='hs-varid'>val</span><span class='hs-layout'>,</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>ann</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>val</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Capture</span> <span class='hs-varid'>ann</span>
<a name="line-164"></a><span class='hs-definition'>capture</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-varid'>fmap</span> <span class='hs-layout'>(</span><span class='hs-varid'>fmap</span> <span class='hs-varid'>fromAny</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>force</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Any</span> <span class='hs-varid'>x</span>
<a name="line-165"></a>
<a name="line-166"></a>
<a name="line-167"></a><a name="force"></a><span class='hs-definition'>force</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Any</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>IO</span> <span class='hs-layout'>(</span><span class='hs-conid'>Capture</span> <span class='hs-conid'>Any</span><span class='hs-layout'>)</span>
<a name="line-168"></a><span class='hs-definition'>force</span> <span class='hs-varid'>x</span><span class='hs-keyglyph'>@</span><span class='hs-layout'>(</span><span class='hs-conid'>Any</span> <span class='hs-varid'>xx</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>do</span>
<a name="line-169"></a> <span class='hs-varid'>push</span>
<a name="line-170"></a> <span class='hs-varid'>res</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>try</span> <span class='hs-varop'>$</span> <span class='hs-varid'>evaluate</span> <span class='hs-varid'>xx</span>
<a name="line-171"></a> <span class='hs-varid'>y</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>pop</span>
<a name="line-172"></a> <span class='hs-keyword'>case</span> <span class='hs-varid'>y</span> <span class='hs-keyword'>of</span>
<a name="line-173"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>Left</span> <span class='hs-layout'>(</span><span class='hs-keyword'>_</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>RecConError</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>res</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Missing</span> <span class='hs-varid'>x</span>
<a name="line-174"></a> <span class='hs-conid'>Right</span> <span class='hs-varid'>r</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varid'>r</span>
<a name="line-175"></a> <span class='hs-conid'>Left</span> <span class='hs-varid'>f</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-varop'>$</span> <span class='hs-varid'>isAlgType</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Value</span> <span class='hs-varid'>x</span>
<a name="line-176"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyword'>do</span>
<a name="line-177"></a> <span class='hs-varid'>cs</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>mapM</span> <span class='hs-varid'>force</span> <span class='hs-varop'>$</span> <span class='hs-varid'>children</span> <span class='hs-varid'>x</span>
<a name="line-178"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Ctor</span> <span class='hs-varid'>x</span> <span class='hs-varid'>cs</span>
<a name="line-179"></a>
<a name="line-180"></a>
<a name="line-181"></a><a name="&="></a><span class='hs-comment'>-- | Add an annotation to a value.</span>
<a name="line-182"></a><span class='hs-comment'>--</span>
<a name="line-183"></a><span class='hs-comment'>-- It is recommended that anyone making use of this function redefine</span>
<a name="line-184"></a><span class='hs-comment'>-- it with a more restrictive type signature to control the type of the</span>
<a name="line-185"></a><span class='hs-comment'>-- annotation (the second argument). Any redefinitions of this function</span>
<a name="line-186"></a><span class='hs-comment'>-- should add an INLINE pragma, to reduce the chance of incorrect</span>
<a name="line-187"></a><span class='hs-comment'>-- optimisations.</span>
<a name="line-188"></a><span class='hs-comment'>{-# INLINE (&=) #-}</span>
<a name="line-189"></a><span class='hs-layout'>(</span><span class='hs-varop'>&=</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-layout'>(</span><span class='hs-conid'>Data</span> <span class='hs-varid'>val</span><span class='hs-layout'>,</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>ann</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>val</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>ann</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>val</span>
<a name="line-190"></a><span class='hs-layout'>(</span><span class='hs-varop'>&=</span><span class='hs-layout'>)</span> <span class='hs-varid'>x</span> <span class='hs-varid'>y</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>addAnn</span> <span class='hs-layout'>(</span><span class='hs-varid'>id_</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-layout'>(</span><span class='hs-varid'>id_</span> <span class='hs-varid'>y</span><span class='hs-layout'>)</span>
<a name="line-191"></a>
<a name="line-192"></a><a name="id_"></a><span class='hs-comment'>{-# INLINE id_ #-}</span>
<a name="line-193"></a><span class='hs-definition'>id_</span> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span>
<a name="line-194"></a><span class='hs-definition'>id_</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>unit</span> <span class='hs-keyword'>of</span> <span class='hs-conid'>()</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>x</span>
<a name="line-195"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>unit</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>reverse</span> <span class='hs-str'>""</span> <span class='hs-varop'>`seq`</span> <span class='hs-conid'>()</span>
<a name="line-196"></a>
<a name="line-197"></a>
<a name="line-198"></a><span class='hs-comment'>---------------------------------------------------------------------</span>
<a name="line-199"></a><span class='hs-comment'>-- PURE PART</span>
<a name="line-200"></a>
<a name="line-201"></a><a name="Annotate"></a><span class='hs-comment'>-- | This type represents an annotated value. The type of the underlying value is not specified.</span>
<a name="line-202"></a><a name="Annotate"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span>
<a name="line-203"></a> <span class='hs-keyglyph'>=</span> <span class='hs-keyword'>forall</span> <span class='hs-varid'>c</span> <span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-layout'>(</span><span class='hs-conid'>Data</span> <span class='hs-varid'>c</span><span class='hs-layout'>,</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-conop'>:=</span> <span class='hs-varid'>f</span> <span class='hs-comment'>-- ^ Construct a field, @fieldname := value@.</span>
<a name="line-204"></a> <span class='hs-keyglyph'>|</span> <span class='hs-keyword'>forall</span> <span class='hs-varid'>c</span> <span class='hs-varid'>f</span> <span class='hs-varop'>.</span> <span class='hs-layout'>(</span><span class='hs-conid'>Data</span> <span class='hs-varid'>c</span><span class='hs-layout'>,</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=></span> <span class='hs-layout'>(</span><span class='hs-varid'>c</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>f</span><span class='hs-layout'>)</span> <span class='hs-conop'>:=+</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span><span class='hs-keyglyph'>]</span> <span class='hs-comment'>-- ^ Add annotations to a field.</span>
<a name="line-205"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>AAnn</span> <span class='hs-varid'>ann</span> <span class='hs-layout'>(</span><span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span><span class='hs-layout'>)</span>
<a name="line-206"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>AMany</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span><span class='hs-keyglyph'>]</span>
<a name="line-207"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>AAtom</span> <span class='hs-conid'>Any</span>
<a name="line-208"></a> <span class='hs-keyglyph'>|</span> <span class='hs-conid'>ACtor</span> <span class='hs-conid'>Any</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span><span class='hs-keyglyph'>]</span>
<a name="line-209"></a> <span class='hs-keyword'>deriving</span> <span class='hs-conid'>Typeable</span>
<a name="line-210"></a> <span class='hs-comment'>-- specifically DOES NOT derive Data, to avoid people accidentally including it</span>
<a name="line-211"></a>
<a name="line-212"></a>
<a name="line-213"></a><a name="+="></a><span class='hs-comment'>-- | Add an annotation to a value.</span>
<a name="line-214"></a><span class='hs-layout'>(</span><span class='hs-varop'>+=</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>ann</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span>
<a name="line-215"></a><span class='hs-layout'>(</span><span class='hs-varop'>+=</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>flip</span> <span class='hs-conid'>AAnn</span>
<a name="line-216"></a>
<a name="line-217"></a><a name="many_"></a><span class='hs-comment'>-- | Collapse many annotated values in to one.</span>
<a name="line-218"></a><span class='hs-definition'>many_</span> <span class='hs-keyglyph'>::</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Annotate</span> <span class='hs-varid'>a</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>a</span>
<a name="line-219"></a><span class='hs-definition'>many_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AMany</span>
<a name="line-220"></a>
<a name="line-221"></a><a name="atom"></a><span class='hs-comment'>-- | Lift a pure value to an annotation.</span>
<a name="line-222"></a><span class='hs-definition'>atom</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>val</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>val</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span>
<a name="line-223"></a><span class='hs-definition'>atom</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>AAtom</span> <span class='hs-varop'>.</span> <span class='hs-conid'>Any</span>
<a name="line-224"></a>
<a name="line-225"></a><a name="record"></a><span class='hs-comment'>-- | Create a constructor/record. The first argument should be</span>
<a name="line-226"></a><span class='hs-comment'>-- the type of field, the second should be a list of fields constructed</span>
<a name="line-227"></a><span class='hs-comment'>-- originally defined by @:=@ or @:=+@.</span>
<a name="line-228"></a><span class='hs-comment'>--</span>
<a name="line-229"></a><span class='hs-comment'>-- This operation is not type safe, and may raise an exception at runtime</span>
<a name="line-230"></a><span class='hs-comment'>-- if any field has the wrong type or label.</span>
<a name="line-231"></a><span class='hs-definition'>record</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Data</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span><span class='hs-keyglyph'>]</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>ann</span>
<a name="line-232"></a><span class='hs-definition'>record</span> <span class='hs-varid'>a</span> <span class='hs-varid'>b</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>ACtor</span> <span class='hs-layout'>(</span><span class='hs-conid'>Any</span> <span class='hs-varid'>a</span><span class='hs-layout'>)</span> <span class='hs-varid'>b</span>
<a name="line-233"></a>
<a name="line-234"></a><a name="capture_"></a><span class='hs-comment'>-- | Capture the annotations from an annotated value.</span>
<a name="line-235"></a><span class='hs-definition'>capture_</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Show</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>=></span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Capture</span> <span class='hs-varid'>a</span>
<a name="line-236"></a><span class='hs-definition'>capture_</span> <span class='hs-layout'>(</span><span class='hs-conid'>AAnn</span> <span class='hs-varid'>a</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Ann</span> <span class='hs-varid'>a</span> <span class='hs-layout'>(</span><span class='hs-varid'>capture_</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span>
<a name="line-237"></a><span class='hs-definition'>capture_</span> <span class='hs-layout'>(</span><span class='hs-conid'>AMany</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Many</span> <span class='hs-layout'>(</span><span class='hs-varid'>map</span> <span class='hs-varid'>capture_</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-238"></a><span class='hs-definition'>capture_</span> <span class='hs-layout'>(</span><span class='hs-conid'>AAtom</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Value</span> <span class='hs-varid'>x</span>
<a name="line-239"></a><span class='hs-definition'>capture_</span> <span class='hs-layout'>(</span><span class='hs-keyword'>_</span> <span class='hs-conop'>:=</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Value</span> <span class='hs-varop'>$</span> <span class='hs-conid'>Any</span> <span class='hs-varid'>c</span>
<a name="line-240"></a><span class='hs-definition'>capture_</span> <span class='hs-layout'>(</span><span class='hs-keyword'>_</span> <span class='hs-conop'>:=+</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Many</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-varid'>capture_</span> <span class='hs-varid'>c</span>
<a name="line-241"></a><span class='hs-definition'>capture_</span> <span class='hs-layout'>(</span><span class='hs-conid'>ACtor</span> <span class='hs-varid'>x</span> <span class='hs-varid'>xs</span><span class='hs-layout'>)</span>
<a name="line-242"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>not</span> <span class='hs-varop'>$</span> <span class='hs-varid'>null</span> <span class='hs-varid'>rep</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Some fields got repeated under "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>x</span> <span class='hs-varop'>++</span> <span class='hs-str'>"."</span> <span class='hs-varop'>++</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>x</span> <span class='hs-varop'>++</span> <span class='hs-str'>": "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>rep</span>
<a name="line-243"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Ctor</span> <span class='hs-varid'>x2</span> <span class='hs-varid'>xs2</span>
<a name="line-244"></a> <span class='hs-keyword'>where</span>
<a name="line-245"></a> <span class='hs-varid'>x2</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>recompose</span> <span class='hs-varid'>x</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-varid'>fromCapture</span> <span class='hs-varid'>xs2</span>
<a name="line-246"></a> <span class='hs-varid'>xs2</span> <span class='hs-keyglyph'>=</span> <span class='hs-keyglyph'>[</span><span class='hs-varid'>fromMaybe</span> <span class='hs-layout'>(</span><span class='hs-conid'>Missing</span> <span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-varop'>$</span> <span class='hs-varid'>lookup</span> <span class='hs-varid'>i</span> <span class='hs-varid'>is</span> <span class='hs-keyglyph'>|</span> <span class='hs-keyword'>let</span> <span class='hs-varid'>is</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>zip</span> <span class='hs-varid'>inds</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-varid'>capture_</span> <span class='hs-varid'>xs</span><span class='hs-layout'>,</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-layout'>,</span><span class='hs-varid'>c</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>zip</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>0</span><span class='hs-keyglyph'>..</span><span class='hs-keyglyph'>]</span> <span class='hs-varop'>$</span> <span class='hs-varid'>children</span> <span class='hs-varid'>x</span><span class='hs-keyglyph'>]</span>
<a name="line-247"></a> <span class='hs-varid'>inds</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>zipWith</span> <span class='hs-varid'>fromMaybe</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>0</span><span class='hs-keyglyph'>..</span><span class='hs-keyglyph'>]</span> <span class='hs-varop'>$</span> <span class='hs-varid'>map</span> <span class='hs-layout'>(</span><span class='hs-varid'>fieldIndex</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-varid'>xs</span>
<a name="line-248"></a> <span class='hs-varid'>rep</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>inds</span> <span class='hs-varop'>\\</span> <span class='hs-varid'>nub</span> <span class='hs-varid'>inds</span>
<a name="line-249"></a>
<a name="line-250"></a>
<a name="line-251"></a><a name="fieldIndex"></a><span class='hs-definition'>fieldIndex</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Any</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Annotate</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-252"></a><span class='hs-definition'>fieldIndex</span> <span class='hs-varid'>ctor</span> <span class='hs-layout'>(</span><span class='hs-conid'>AAnn</span> <span class='hs-varid'>a</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fieldIndex</span> <span class='hs-varid'>ctor</span> <span class='hs-varid'>x</span>
<a name="line-253"></a><span class='hs-definition'>fieldIndex</span> <span class='hs-varid'>ctor</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-conop'>:=</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>fieldIndex</span> <span class='hs-varid'>ctor</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-conop'>:=+</span> <span class='hs-conid'>[]</span><span class='hs-layout'>)</span>
<a name="line-254"></a><span class='hs-definition'>fieldIndex</span> <span class='hs-varid'>ctor</span> <span class='hs-layout'>(</span><span class='hs-varid'>f</span> <span class='hs-conop'>:=+</span> <span class='hs-keyword'>_</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>isJust</span> <span class='hs-varid'>res</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>res</span>
<a name="line-255"></a> <span class='hs-keyglyph'>|</span> <span class='hs-varid'>otherwise</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>error</span> <span class='hs-varop'>$</span> <span class='hs-str'>"Couldn't resolve field for "</span> <span class='hs-varop'>++</span> <span class='hs-varid'>show</span> <span class='hs-varid'>ctor</span>
<a name="line-256"></a> <span class='hs-keyword'>where</span> <span class='hs-varid'>c</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>recompose</span> <span class='hs-varid'>ctor</span> <span class='hs-keyglyph'>[</span><span class='hs-conid'>Any</span> <span class='hs-varop'>$</span> <span class='hs-varid'>throwInt</span> <span class='hs-varid'>i</span> <span class='hs-varop'>`asTypeOf`</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>|</span> <span class='hs-layout'>(</span><span class='hs-varid'>i</span><span class='hs-layout'>,</span><span class='hs-conid'>Any</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>zip</span> <span class='hs-keyglyph'>[</span><span class='hs-num'>0</span><span class='hs-keyglyph'>..</span><span class='hs-keyglyph'>]</span> <span class='hs-layout'>(</span><span class='hs-varid'>children</span> <span class='hs-varid'>ctor</span><span class='hs-layout'>)</span><span class='hs-keyglyph'>]</span>
<a name="line-257"></a> <span class='hs-varid'>res</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>catchInt</span> <span class='hs-varop'>$</span> <span class='hs-varid'>f</span> <span class='hs-varop'>$</span> <span class='hs-varid'>fromAny</span> <span class='hs-varid'>c</span>
<a name="line-258"></a><span class='hs-definition'>fieldIndex</span> <span class='hs-keyword'>_</span> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>Nothing</span>
<a name="line-259"></a>
<a name="line-260"></a>
<a name="line-261"></a>
<a name="line-262"></a><a name="ExceptionInt"></a><span class='hs-keyword'>data</span> <span class='hs-conid'>ExceptionInt</span> <span class='hs-keyglyph'>=</span> <span class='hs-conid'>ExceptionInt</span> <span class='hs-conid'>Int</span> <span class='hs-keyword'>deriving</span> <span class='hs-layout'>(</span><span class='hs-conid'>Show</span><span class='hs-layout'>,</span> <span class='hs-conid'>Typeable</span><span class='hs-layout'>)</span>
<a name="line-263"></a><span class='hs-keyword'>instance</span> <span class='hs-conid'>Exception</span> <span class='hs-conid'>ExceptionInt</span>
<a name="line-264"></a>
<a name="line-265"></a>
<a name="line-266"></a><a name="throwInt"></a><span class='hs-definition'>throwInt</span> <span class='hs-keyglyph'>::</span> <span class='hs-conid'>Int</span> <span class='hs-keyglyph'>-></span> <span class='hs-varid'>a</span>
<a name="line-267"></a><span class='hs-definition'>throwInt</span> <span class='hs-varid'>i</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>throw</span> <span class='hs-layout'>(</span><span class='hs-conid'>ExceptionInt</span> <span class='hs-varid'>i</span><span class='hs-layout'>)</span>
<a name="line-268"></a>
<a name="line-269"></a>
<a name="line-270"></a><a name="catchInt"></a><span class='hs-comment'>{-# NOINLINE catchInt #-}</span>
<a name="line-271"></a><span class='hs-definition'>catchInt</span> <span class='hs-keyglyph'>::</span> <span class='hs-varid'>a</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Maybe</span> <span class='hs-conid'>Int</span>
<a name="line-272"></a><span class='hs-definition'>catchInt</span> <span class='hs-varid'>x</span> <span class='hs-keyglyph'>=</span> <span class='hs-varid'>unsafePerformIO</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>do</span>
<a name="line-273"></a> <span class='hs-varid'>y</span> <span class='hs-keyglyph'><-</span> <span class='hs-varid'>try</span> <span class='hs-layout'>(</span><span class='hs-varid'>evaluate</span> <span class='hs-varid'>x</span><span class='hs-layout'>)</span>
<a name="line-274"></a> <span class='hs-varid'>return</span> <span class='hs-varop'>$</span> <span class='hs-keyword'>case</span> <span class='hs-varid'>y</span> <span class='hs-keyword'>of</span>
<a name="line-275"></a> <span class='hs-conid'>Left</span> <span class='hs-layout'>(</span><span class='hs-conid'>ExceptionInt</span> <span class='hs-varid'>z</span><span class='hs-layout'>)</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Just</span> <span class='hs-varid'>z</span>
<a name="line-276"></a> <span class='hs-keyword'>_</span> <span class='hs-keyglyph'>-></span> <span class='hs-conid'>Nothing</span>
</pre></body>
</html>
distrib
>
Fedora
>
17
>
i386
>
media
>
updates
>
by-pkgid
>
a754cb499dfee5e1f453d3b6cc13d4c8
>
files
>
143
