hxt-8.0.0: doc/hdoc/src/Text-XML-HXT-Arrow-XmlIOStateArrow.html
<!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://www.cs.york.ac.uk/fp/darcs/hscolour/ -->
<title>Haskell Code by HsColour</title>
<link type='text/css' rel='stylesheet' href='hscolour.css' />
</head>
<body>
<pre><a name="line-1"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-2"></a>
<a name="line-3"></a><span class='comment'>{- |
<a name="line-4"></a> Module : Text.XML.HXT.Arrow.XmlIOStateArrow
<a name="line-5"></a> Copyright : Copyright (C) 2005 Uwe Schmidt
<a name="line-6"></a> License : MIT
<a name="line-7"></a>
<a name="line-8"></a> Maintainer : Uwe Schmidt (uwe@fh-wedel.de)
<a name="line-9"></a> Stability : experimental
<a name="line-10"></a> Portability: portable
<a name="line-11"></a> Version : $Id: XmlIOStateArrow.hs,v 1.39 2006/11/09 20:27:42 hxml Exp $
<a name="line-12"></a>
<a name="line-13"></a> the basic state arrows for XML processing
<a name="line-14"></a>
<a name="line-15"></a> A state is needed for global processing options,
<a name="line-16"></a> like encoding options, document base URI, trace levels
<a name="line-17"></a> and error message handling
<a name="line-18"></a>
<a name="line-19"></a> The state is separated into a user defined state
<a name="line-20"></a> and a system state. The system state contains variables
<a name="line-21"></a> for error message handling, for tracing, for the document base
<a name="line-22"></a> for accessing XML documents with relative references, e.g. DTDs,
<a name="line-23"></a> and a global key value store. This assoc list has strings as keys
<a name="line-24"></a> and lists of XmlTrees as values. It is used to store arbitrary
<a name="line-25"></a> XML and text values, e.g. user defined global options.
<a name="line-26"></a>
<a name="line-27"></a> The user defined part of the store is in the default case empty, defined as ().
<a name="line-28"></a> It can be extended with an arbitray data type
<a name="line-29"></a>
<a name="line-30"></a>-}</span>
<a name="line-31"></a>
<a name="line-32"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-33"></a>
<a name="line-34"></a><span class='keyword'>module</span> <span class='conid'>Text</span><span class='varop'>.</span><span class='conid'>XML</span><span class='varop'>.</span><span class='conid'>HXT</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>XmlIOStateArrow</span>
<a name="line-35"></a> <span class='layout'>(</span> <span class='comment'>-- * Data Types</span>
<a name="line-36"></a> <span class='conid'>XIOState</span><span class='layout'>(</span><span class='keyglyph'>..</span><span class='layout'>)</span><span class='layout'>,</span>
<a name="line-37"></a> <span class='conid'>XIOSysState</span><span class='layout'>(</span><span class='keyglyph'>..</span><span class='layout'>)</span><span class='layout'>,</span>
<a name="line-38"></a> <span class='conid'>IOStateArrow</span><span class='layout'>,</span>
<a name="line-39"></a> <span class='conid'>IOSArrow</span><span class='layout'>,</span>
<a name="line-40"></a>
<a name="line-41"></a> <span class='comment'>-- * Running Arrows</span>
<a name="line-42"></a> <span class='varid'>initialState</span><span class='layout'>,</span>
<a name="line-43"></a> <span class='varid'>initialSysState</span><span class='layout'>,</span>
<a name="line-44"></a> <span class='varid'>runX</span><span class='layout'>,</span>
<a name="line-45"></a>
<a name="line-46"></a> <span class='comment'>-- * User State Manipulation</span>
<a name="line-47"></a> <span class='varid'>getUserState</span><span class='layout'>,</span>
<a name="line-48"></a> <span class='varid'>setUserState</span><span class='layout'>,</span>
<a name="line-49"></a> <span class='varid'>changeUserState</span><span class='layout'>,</span>
<a name="line-50"></a> <span class='varid'>withExtendedUserState</span><span class='layout'>,</span>
<a name="line-51"></a> <span class='varid'>withOtherUserState</span><span class='layout'>,</span>
<a name="line-52"></a>
<a name="line-53"></a> <span class='comment'>-- * Global System State Access</span>
<a name="line-54"></a> <span class='varid'>getSysParam</span><span class='layout'>,</span>
<a name="line-55"></a> <span class='varid'>changeSysParam</span><span class='layout'>,</span>
<a name="line-56"></a>
<a name="line-57"></a> <span class='varid'>setParamList</span><span class='layout'>,</span>
<a name="line-58"></a> <span class='varid'>setParam</span><span class='layout'>,</span>
<a name="line-59"></a> <span class='varid'>unsetParam</span><span class='layout'>,</span>
<a name="line-60"></a> <span class='varid'>getParam</span><span class='layout'>,</span>
<a name="line-61"></a> <span class='varid'>getAllParams</span><span class='layout'>,</span>
<a name="line-62"></a> <span class='varid'>setParamString</span><span class='layout'>,</span>
<a name="line-63"></a> <span class='varid'>getParamString</span><span class='layout'>,</span>
<a name="line-64"></a> <span class='varid'>setParamInt</span><span class='layout'>,</span>
<a name="line-65"></a> <span class='varid'>getParamInt</span><span class='layout'>,</span>
<a name="line-66"></a>
<a name="line-67"></a> <span class='comment'>-- * Error Message Handling</span>
<a name="line-68"></a> <span class='varid'>clearErrStatus</span><span class='layout'>,</span>
<a name="line-69"></a> <span class='varid'>setErrStatus</span><span class='layout'>,</span>
<a name="line-70"></a> <span class='varid'>getErrStatus</span><span class='layout'>,</span>
<a name="line-71"></a> <span class='varid'>setErrMsgStatus</span><span class='layout'>,</span>
<a name="line-72"></a> <span class='varid'>setErrorMsgHandler</span><span class='layout'>,</span>
<a name="line-73"></a>
<a name="line-74"></a> <span class='varid'>errorMsgStderr</span><span class='layout'>,</span>
<a name="line-75"></a> <span class='varid'>errorMsgCollect</span><span class='layout'>,</span>
<a name="line-76"></a> <span class='varid'>errorMsgStderrAndCollect</span><span class='layout'>,</span>
<a name="line-77"></a> <span class='varid'>errorMsgIgnore</span><span class='layout'>,</span>
<a name="line-78"></a>
<a name="line-79"></a> <span class='varid'>getErrorMessages</span><span class='layout'>,</span>
<a name="line-80"></a>
<a name="line-81"></a> <span class='varid'>filterErrorMsg</span><span class='layout'>,</span>
<a name="line-82"></a> <span class='varid'>issueWarn</span><span class='layout'>,</span>
<a name="line-83"></a> <span class='varid'>issueErr</span><span class='layout'>,</span>
<a name="line-84"></a> <span class='varid'>issueFatal</span><span class='layout'>,</span>
<a name="line-85"></a> <span class='varid'>setDocumentStatus</span><span class='layout'>,</span>
<a name="line-86"></a> <span class='varid'>setDocumentStatusFromSystemState</span><span class='layout'>,</span>
<a name="line-87"></a> <span class='varid'>documentStatusOk</span><span class='layout'>,</span>
<a name="line-88"></a>
<a name="line-89"></a> <span class='comment'>-- * Document Base</span>
<a name="line-90"></a> <span class='varid'>setBaseURI</span><span class='layout'>,</span>
<a name="line-91"></a> <span class='varid'>getBaseURI</span><span class='layout'>,</span>
<a name="line-92"></a> <span class='varid'>changeBaseURI</span><span class='layout'>,</span>
<a name="line-93"></a> <span class='varid'>setDefaultBaseURI</span><span class='layout'>,</span>
<a name="line-94"></a> <span class='varid'>getDefaultBaseURI</span><span class='layout'>,</span>
<a name="line-95"></a> <span class='varid'>runInLocalURIContext</span><span class='layout'>,</span>
<a name="line-96"></a>
<a name="line-97"></a> <span class='comment'>-- * Tracing</span>
<a name="line-98"></a> <span class='varid'>setTraceLevel</span><span class='layout'>,</span>
<a name="line-99"></a> <span class='varid'>getTraceLevel</span><span class='layout'>,</span>
<a name="line-100"></a> <span class='varid'>withTraceLevel</span><span class='layout'>,</span>
<a name="line-101"></a> <span class='varid'>trace</span><span class='layout'>,</span>
<a name="line-102"></a> <span class='varid'>traceMsg</span><span class='layout'>,</span>
<a name="line-103"></a> <span class='varid'>traceString</span><span class='layout'>,</span>
<a name="line-104"></a> <span class='varid'>traceSource</span><span class='layout'>,</span>
<a name="line-105"></a> <span class='varid'>traceTree</span><span class='layout'>,</span>
<a name="line-106"></a> <span class='varid'>traceDoc</span><span class='layout'>,</span>
<a name="line-107"></a> <span class='varid'>traceState</span><span class='layout'>,</span>
<a name="line-108"></a>
<a name="line-109"></a> <span class='comment'>-- * URI Manipulation</span>
<a name="line-110"></a> <span class='varid'>expandURIString</span><span class='layout'>,</span>
<a name="line-111"></a> <span class='varid'>expandURI</span><span class='layout'>,</span>
<a name="line-112"></a> <span class='varid'>mkAbsURI</span><span class='layout'>,</span>
<a name="line-113"></a>
<a name="line-114"></a> <span class='varid'>getFragmentFromURI</span><span class='layout'>,</span>
<a name="line-115"></a> <span class='varid'>getPathFromURI</span><span class='layout'>,</span>
<a name="line-116"></a> <span class='varid'>getPortFromURI</span><span class='layout'>,</span>
<a name="line-117"></a> <span class='varid'>getQueryFromURI</span><span class='layout'>,</span>
<a name="line-118"></a> <span class='varid'>getRegNameFromURI</span><span class='layout'>,</span>
<a name="line-119"></a> <span class='varid'>getSchemeFromURI</span><span class='layout'>,</span>
<a name="line-120"></a> <span class='varid'>getUserInfoFromURI</span>
<a name="line-121"></a> <span class='layout'>)</span>
<a name="line-122"></a><span class='keyword'>where</span>
<a name="line-123"></a>
<a name="line-124"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span> <span class='comment'>-- arrow classes</span>
<a name="line-125"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>ArrowList</span>
<a name="line-126"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>ArrowIf</span>
<a name="line-127"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>ArrowTree</span>
<a name="line-128"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>ArrowIO</span>
<a name="line-129"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>IOStateListArrow</span>
<a name="line-130"></a>
<a name="line-131"></a><span class='keyword'>import</span> <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Strategies</span><span class='varop'>.</span><span class='conid'>DeepSeq</span>
<a name="line-132"></a>
<a name="line-133"></a><span class='keyword'>import</span> <span class='conid'>Text</span><span class='varop'>.</span><span class='conid'>XML</span><span class='varop'>.</span><span class='conid'>HXT</span><span class='varop'>.</span><span class='conid'>DOM</span><span class='varop'>.</span><span class='conid'>Interface</span>
<a name="line-134"></a><span class='keyword'>import</span> <span class='conid'>Text</span><span class='varop'>.</span><span class='conid'>XML</span><span class='varop'>.</span><span class='conid'>HXT</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>XmlArrow</span>
<a name="line-135"></a>
<a name="line-136"></a><span class='keyword'>import</span> <span class='conid'>Text</span><span class='varop'>.</span><span class='conid'>XML</span><span class='varop'>.</span><span class='conid'>HXT</span><span class='varop'>.</span><span class='conid'>Arrow</span><span class='varop'>.</span><span class='conid'>Edit</span>
<a name="line-137"></a> <span class='layout'>(</span> <span class='varid'>addHeadlineToXmlDoc</span>
<a name="line-138"></a> <span class='layout'>,</span> <span class='varid'>treeRepOfXmlDoc</span>
<a name="line-139"></a> <span class='layout'>,</span> <span class='varid'>indentDoc</span>
<a name="line-140"></a> <span class='layout'>)</span>
<a name="line-141"></a>
<a name="line-142"></a><span class='keyword'>import</span> <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>Maybe</span>
<a name="line-143"></a>
<a name="line-144"></a><span class='keyword'>import</span> <span class='conid'>Network</span><span class='varop'>.</span><span class='conid'>URI</span>
<a name="line-145"></a> <span class='layout'>(</span> <span class='conid'>URI</span>
<a name="line-146"></a> <span class='layout'>,</span> <span class='varid'>escapeURIChar</span>
<a name="line-147"></a> <span class='layout'>,</span> <span class='varid'>isUnescapedInURI</span>
<a name="line-148"></a> <span class='layout'>,</span> <span class='varid'>nonStrictRelativeTo</span>
<a name="line-149"></a> <span class='layout'>,</span> <span class='varid'>parseURIReference</span>
<a name="line-150"></a> <span class='layout'>,</span> <span class='varid'>uriAuthority</span>
<a name="line-151"></a> <span class='layout'>,</span> <span class='varid'>uriFragment</span>
<a name="line-152"></a> <span class='layout'>,</span> <span class='varid'>uriPath</span>
<a name="line-153"></a> <span class='layout'>,</span> <span class='varid'>uriPort</span>
<a name="line-154"></a> <span class='layout'>,</span> <span class='varid'>uriQuery</span>
<a name="line-155"></a> <span class='layout'>,</span> <span class='varid'>uriRegName</span>
<a name="line-156"></a> <span class='layout'>,</span> <span class='varid'>uriScheme</span>
<a name="line-157"></a> <span class='layout'>,</span> <span class='varid'>uriUserInfo</span>
<a name="line-158"></a> <span class='layout'>)</span>
<a name="line-159"></a>
<a name="line-160"></a><span class='keyword'>import</span> <span class='conid'>System</span><span class='varop'>.</span><span class='conid'>IO</span>
<a name="line-161"></a> <span class='layout'>(</span> <span class='varid'>hPutStrLn</span>
<a name="line-162"></a> <span class='layout'>,</span> <span class='varid'>hFlush</span>
<a name="line-163"></a> <span class='layout'>,</span> <span class='varid'>stderr</span>
<a name="line-164"></a> <span class='layout'>)</span>
<a name="line-165"></a>
<a name="line-166"></a><span class='keyword'>import</span> <span class='conid'>System</span><span class='varop'>.</span><span class='conid'>Directory</span>
<a name="line-167"></a> <span class='layout'>(</span> <span class='varid'>getCurrentDirectory</span>
<a name="line-168"></a> <span class='layout'>)</span>
<a name="line-169"></a>
<a name="line-170"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-171"></a><span class='comment'>{- $datatypes -}</span>
<a name="line-172"></a>
<a name="line-173"></a>
<a name="line-174"></a><span class='comment'>-- |</span>
<a name="line-175"></a><span class='comment'>-- predefined system state data type with all components for the</span>
<a name="line-176"></a><span class='comment'>-- system functions, like trace, error handling, ...</span>
<a name="line-177"></a>
<a name="line-178"></a><a name="XIOSysState"></a><span class='keyword'>data</span> <span class='conid'>XIOSysState</span> <span class='keyglyph'>=</span> <span class='conid'>XIOSys</span> <span class='layout'>{</span> <span class='varid'>xio_trace</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>Int</span>
<a name="line-179"></a> <span class='layout'>,</span> <span class='varid'>xio_errorStatus</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>Int</span>
<a name="line-180"></a> <span class='layout'>,</span> <span class='varid'>xio_errorModule</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>String</span>
<a name="line-181"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgHandler</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IO</span> <span class='conid'>()</span>
<a name="line-182"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgCollect</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>Bool</span>
<a name="line-183"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgList</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>XmlTrees</span>
<a name="line-184"></a> <span class='layout'>,</span> <span class='varid'>xio_baseURI</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>String</span>
<a name="line-185"></a> <span class='layout'>,</span> <span class='varid'>xio_defaultBaseURI</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>String</span>
<a name="line-186"></a> <span class='layout'>,</span> <span class='varid'>xio_attrList</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='layout'>(</span><span class='conid'>AssocList</span> <span class='conid'>String</span> <span class='conid'>XmlTrees</span><span class='layout'>)</span>
<a name="line-187"></a> <span class='layout'>}</span>
<a name="line-188"></a>
<a name="line-189"></a><span class='keyword'>instance</span> <span class='conid'>DeepSeq</span> <span class='conid'>XIOSysState</span> <span class='keyword'>where</span>
<a name="line-190"></a> <span class='varid'>deepSeq</span> <span class='layout'>(</span><span class='conid'>XIOSys</span> <span class='varid'>tr</span> <span class='varid'>es</span> <span class='varid'>em</span> <span class='varid'>emh</span> <span class='varid'>emc</span> <span class='varid'>eml</span> <span class='varid'>bu</span> <span class='varid'>du</span> <span class='varid'>al</span><span class='layout'>)</span> <span class='varid'>y</span>
<a name="line-191"></a> <span class='keyglyph'>=</span> <span class='varid'>deepSeq</span> <span class='varid'>tr</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>es</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>em</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>emh</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>emc</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>eml</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>bu</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>du</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>al</span> <span class='varid'>y</span>
<a name="line-192"></a>
<a name="line-193"></a><span class='comment'>-- |</span>
<a name="line-194"></a><span class='comment'>-- state datatype consists of a system state and a user state</span>
<a name="line-195"></a><span class='comment'>-- the user state is not fixed</span>
<a name="line-196"></a>
<a name="line-197"></a><a name="XIOState"></a><span class='keyword'>data</span> <span class='conid'>XIOState</span> <span class='varid'>us</span> <span class='keyglyph'>=</span> <span class='conid'>XIOState</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='conid'>XIOSysState</span>
<a name="line-198"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>::</span> <span class='varop'>!</span> <span class='varid'>us</span>
<a name="line-199"></a> <span class='layout'>}</span>
<a name="line-200"></a>
<a name="line-201"></a><span class='keyword'>instance</span> <span class='layout'>(</span><span class='conid'>DeepSeq</span> <span class='varid'>us</span><span class='layout'>)</span> <span class='keyglyph'>=></span> <span class='conid'>DeepSeq</span> <span class='layout'>(</span><span class='conid'>XIOState</span> <span class='varid'>us</span><span class='layout'>)</span> <span class='keyword'>where</span>
<a name="line-202"></a> <span class='varid'>deepSeq</span> <span class='layout'>(</span><span class='conid'>XIOState</span> <span class='varid'>sys</span> <span class='varid'>usr</span><span class='layout'>)</span> <span class='varid'>y</span> <span class='keyglyph'>=</span> <span class='varid'>deepSeq</span> <span class='varid'>sys</span> <span class='varop'>$</span> <span class='varid'>deepSeq</span> <span class='varid'>usr</span> <span class='varid'>y</span>
<a name="line-203"></a>
<a name="line-204"></a><span class='comment'>-- |</span>
<a name="line-205"></a><span class='comment'>-- The arrow type for stateful arrows</span>
<a name="line-206"></a>
<a name="line-207"></a><a name="IOStateArrow"></a><span class='keyword'>type</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>c</span> <span class='keyglyph'>=</span> <span class='conid'>IOSLA</span> <span class='layout'>(</span><span class='conid'>XIOState</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-208"></a>
<a name="line-209"></a><span class='comment'>-- |</span>
<a name="line-210"></a><span class='comment'>-- The arrow for stateful arrows with no user defined state</span>
<a name="line-211"></a>
<a name="line-212"></a><a name="IOSArrow"></a><span class='keyword'>type</span> <span class='conid'>IOSArrow</span> <span class='varid'>b</span> <span class='varid'>c</span> <span class='keyglyph'>=</span> <span class='conid'>IOStateArrow</span> <span class='conid'>()</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-213"></a>
<a name="line-214"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-215"></a>
<a name="line-216"></a>
<a name="line-217"></a><span class='comment'>-- | the default global state, used as initial state when running an 'IOSArrow' with 'runIOSLA' or</span>
<a name="line-218"></a><span class='comment'>-- 'runX'</span>
<a name="line-219"></a>
<a name="line-220"></a><a name="initialState"></a><span class='definition'>initialState</span> <span class='keyglyph'>::</span> <span class='varid'>us</span> <span class='keyglyph'>-></span> <span class='conid'>XIOState</span> <span class='varid'>us</span>
<a name="line-221"></a><span class='definition'>initialState</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='conid'>XIOState</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>=</span> <span class='varid'>initialSysState</span>
<a name="line-222"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>s</span>
<a name="line-223"></a> <span class='layout'>}</span>
<a name="line-224"></a>
<a name="line-225"></a><a name="initialSysState"></a><span class='definition'>initialSysState</span> <span class='keyglyph'>::</span> <span class='conid'>XIOSysState</span>
<a name="line-226"></a><span class='definition'>initialSysState</span> <span class='keyglyph'>=</span> <span class='conid'>XIOSys</span> <span class='layout'>{</span> <span class='varid'>xio_trace</span> <span class='keyglyph'>=</span> <span class='num'>0</span>
<a name="line-227"></a> <span class='layout'>,</span> <span class='varid'>xio_errorStatus</span> <span class='keyglyph'>=</span> <span class='varid'>c_ok</span>
<a name="line-228"></a> <span class='layout'>,</span> <span class='varid'>xio_errorModule</span> <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-229"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgHandler</span> <span class='keyglyph'>=</span> <span class='varid'>hPutStrLn</span> <span class='varid'>stderr</span>
<a name="line-230"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgCollect</span> <span class='keyglyph'>=</span> <span class='conid'>False</span>
<a name="line-231"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgList</span> <span class='keyglyph'>=</span> <span class='conid'>[]</span>
<a name="line-232"></a> <span class='layout'>,</span> <span class='varid'>xio_baseURI</span> <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-233"></a> <span class='layout'>,</span> <span class='varid'>xio_defaultBaseURI</span> <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-234"></a> <span class='layout'>,</span> <span class='varid'>xio_attrList</span> <span class='keyglyph'>=</span> <span class='conid'>[]</span>
<a name="line-235"></a> <span class='layout'>}</span>
<a name="line-236"></a>
<a name="line-237"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-238"></a>
<a name="line-239"></a><span class='comment'>-- |</span>
<a name="line-240"></a><span class='comment'>-- apply an 'IOSArrow' to an empty root node with 'initialState' () as initial state</span>
<a name="line-241"></a><span class='comment'>--</span>
<a name="line-242"></a><span class='comment'>-- the main entry point for running a state arrow with IO</span>
<a name="line-243"></a><span class='comment'>--</span>
<a name="line-244"></a><span class='comment'>-- when running @ runX f@ an empty XML root node is applied to @f@.</span>
<a name="line-245"></a><span class='comment'>-- usually @f@ will start with a constant arrow (ignoring the input), e.g. a 'Text.XML.HXT.Arrow.ReadDocument.readDocument' arrow.</span>
<a name="line-246"></a><span class='comment'>--</span>
<a name="line-247"></a><span class='comment'>-- for usage see examples with 'Text.XML.HXT.Arrow.WriteDocument.writeDocument'</span>
<a name="line-248"></a><span class='comment'>--</span>
<a name="line-249"></a><span class='comment'>-- if input has to be feed into the arrow use 'Control.Arrow.IOStateListArrow.runIOSLA' like in @ runIOSLA f emptyX inputDoc @</span>
<a name="line-250"></a>
<a name="line-251"></a><a name="runX"></a><span class='definition'>runX</span> <span class='keyglyph'>::</span> <span class='conid'>IOSArrow</span> <span class='conid'>XmlTree</span> <span class='varid'>c</span> <span class='keyglyph'>-></span> <span class='conid'>IO</span> <span class='keyglyph'>[</span><span class='varid'>c</span><span class='keyglyph'>]</span>
<a name="line-252"></a><span class='definition'>runX</span> <span class='keyglyph'>=</span> <span class='varid'>runXIOState</span> <span class='layout'>(</span><span class='varid'>initialState</span> <span class='conid'>()</span><span class='layout'>)</span>
<a name="line-253"></a>
<a name="line-254"></a><a name="runXIOState"></a><span class='definition'>runXIOState</span> <span class='keyglyph'>::</span> <span class='conid'>XIOState</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='varid'>c</span> <span class='keyglyph'>-></span> <span class='conid'>IO</span> <span class='keyglyph'>[</span><span class='varid'>c</span><span class='keyglyph'>]</span>
<a name="line-255"></a><span class='definition'>runXIOState</span> <span class='varid'>s0</span> <span class='varid'>f</span>
<a name="line-256"></a> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-257"></a> <span class='layout'>(</span><span class='sel'>_finalState</span><span class='layout'>,</span> <span class='varid'>res</span><span class='layout'>)</span> <span class='keyglyph'><-</span> <span class='varid'>runIOSLA</span> <span class='layout'>(</span><span class='varid'>emptyRoot</span> <span class='varop'>>>></span> <span class='varid'>f</span><span class='layout'>)</span> <span class='varid'>s0</span> <span class='varid'>undefined</span>
<a name="line-258"></a> <span class='varid'>return</span> <span class='varid'>res</span>
<a name="line-259"></a> <span class='keyword'>where</span>
<a name="line-260"></a> <span class='varid'>emptyRoot</span> <span class='keyglyph'>=</span> <span class='varid'>root</span> <span class='conid'>[]</span> <span class='conid'>[]</span>
<a name="line-261"></a>
<a name="line-262"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-263"></a>
<a name="line-264"></a><span class='comment'>{- user state -}</span>
<a name="line-265"></a>
<a name="line-266"></a><span class='comment'>-- | read the user defined part of the state</span>
<a name="line-267"></a>
<a name="line-268"></a><a name="getUserState"></a><span class='definition'>getUserState</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>s</span>
<a name="line-269"></a><span class='definition'>getUserState</span>
<a name="line-270"></a> <span class='keyglyph'>=</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='keyword'>_</span> <span class='keyglyph'>-></span>
<a name="line-271"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>s</span><span class='layout'>,</span> <span class='keyglyph'>[</span><span class='varid'>xio_userState</span> <span class='varid'>s</span><span class='keyglyph'>]</span><span class='layout'>)</span>
<a name="line-272"></a>
<a name="line-273"></a><span class='comment'>-- | change the user defined part of the state</span>
<a name="line-274"></a>
<a name="line-275"></a><a name="changeUserState"></a><span class='definition'>changeUserState</span> <span class='keyglyph'>::</span> <span class='layout'>(</span><span class='varid'>b</span> <span class='keyglyph'>-></span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='varid'>s</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-276"></a><span class='definition'>changeUserState</span> <span class='varid'>cf</span>
<a name="line-277"></a> <span class='keyglyph'>=</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='varid'>v</span> <span class='keyglyph'>-></span>
<a name="line-278"></a> <span class='keyword'>let</span> <span class='varid'>s'</span> <span class='keyglyph'>=</span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>cf</span> <span class='varid'>v</span> <span class='layout'>(</span><span class='varid'>xio_userState</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='layout'>}</span>
<a name="line-279"></a> <span class='keyword'>in</span> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>s'</span><span class='layout'>,</span> <span class='keyglyph'>[</span><span class='varid'>v</span><span class='keyglyph'>]</span><span class='layout'>)</span>
<a name="line-280"></a>
<a name="line-281"></a><span class='comment'>-- | set the user defined part of the state</span>
<a name="line-282"></a>
<a name="line-283"></a><a name="setUserState"></a><span class='definition'>setUserState</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>s</span> <span class='varid'>s</span>
<a name="line-284"></a><span class='definition'>setUserState</span>
<a name="line-285"></a> <span class='keyglyph'>=</span> <span class='varid'>changeUserState</span> <span class='varid'>const</span>
<a name="line-286"></a>
<a name="line-287"></a><span class='comment'>-- | extend user state</span>
<a name="line-288"></a><span class='comment'>--</span>
<a name="line-289"></a><span class='comment'>-- Run an arrow with an extended user state component, The old component</span>
<a name="line-290"></a><span class='comment'>-- is stored together with a new one in a pair, the arrow is executed with this</span>
<a name="line-291"></a><span class='comment'>-- extended state, and the augmented state component is removed form the state</span>
<a name="line-292"></a><span class='comment'>-- when the arrow has finished its execution</span>
<a name="line-293"></a>
<a name="line-294"></a><a name="withExtendedUserState"></a><span class='definition'>withExtendedUserState</span> <span class='keyglyph'>::</span> <span class='varid'>s1</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='layout'>(</span><span class='varid'>s1</span><span class='layout'>,</span> <span class='varid'>s0</span><span class='layout'>)</span> <span class='varid'>b</span> <span class='varid'>c</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s0</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-295"></a><span class='definition'>withExtendedUserState</span> <span class='varid'>initS1</span> <span class='varid'>f</span>
<a name="line-296"></a> <span class='keyglyph'>=</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s0</span> <span class='varid'>x</span> <span class='keyglyph'>-></span>
<a name="line-297"></a> <span class='keyword'>do</span>
<a name="line-298"></a> <span class='keyglyph'>~</span><span class='layout'>(</span><span class='varid'>finalS</span><span class='layout'>,</span> <span class='varid'>res</span><span class='layout'>)</span> <span class='keyglyph'><-</span> <span class='varid'>runIOSLA</span> <span class='varid'>f</span> <span class='layout'>(</span> <span class='conid'>XIOState</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>=</span> <span class='varid'>xio_sysState</span> <span class='varid'>s0</span>
<a name="line-299"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='layout'>(</span><span class='varid'>initS1</span><span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='varid'>s0</span><span class='layout'>)</span>
<a name="line-300"></a> <span class='layout'>}</span>
<a name="line-301"></a> <span class='layout'>)</span> <span class='varid'>x</span>
<a name="line-302"></a> <span class='varid'>return</span> <span class='layout'>(</span> <span class='conid'>XIOState</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>=</span> <span class='varid'>xio_sysState</span> <span class='varid'>finalS</span>
<a name="line-303"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>snd</span> <span class='layout'>(</span><span class='varid'>xio_userState</span> <span class='varid'>finalS</span><span class='layout'>)</span>
<a name="line-304"></a> <span class='layout'>}</span>
<a name="line-305"></a> <span class='layout'>,</span> <span class='varid'>res</span>
<a name="line-306"></a> <span class='layout'>)</span>
<a name="line-307"></a>
<a name="line-308"></a><span class='comment'>-- | change the type of user state</span>
<a name="line-309"></a><span class='comment'>--</span>
<a name="line-310"></a><span class='comment'>-- This conversion is useful, when running a state arrow with another</span>
<a name="line-311"></a><span class='comment'>-- structure of the user state, e.g. with () when executing some IO arrows</span>
<a name="line-312"></a>
<a name="line-313"></a><a name="withOtherUserState"></a><span class='definition'>withOtherUserState</span> <span class='keyglyph'>::</span> <span class='varid'>s1</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s1</span> <span class='varid'>b</span> <span class='varid'>c</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s0</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-314"></a><span class='definition'>withOtherUserState</span> <span class='varid'>s1</span> <span class='varid'>f</span>
<a name="line-315"></a> <span class='keyglyph'>=</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='varid'>x</span> <span class='keyglyph'>-></span>
<a name="line-316"></a> <span class='keyword'>do</span>
<a name="line-317"></a> <span class='layout'>(</span><span class='varid'>s'</span><span class='layout'>,</span> <span class='varid'>res</span><span class='layout'>)</span> <span class='keyglyph'><-</span> <span class='varid'>runIOSLA</span> <span class='varid'>f</span> <span class='layout'>(</span> <span class='conid'>XIOState</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>=</span> <span class='varid'>xio_sysState</span> <span class='varid'>s</span>
<a name="line-318"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>s1</span>
<a name="line-319"></a> <span class='layout'>}</span>
<a name="line-320"></a> <span class='layout'>)</span> <span class='varid'>x</span>
<a name="line-321"></a> <span class='varid'>return</span> <span class='layout'>(</span> <span class='conid'>XIOState</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>=</span> <span class='varid'>xio_sysState</span> <span class='varid'>s'</span>
<a name="line-322"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>xio_userState</span> <span class='varid'>s</span>
<a name="line-323"></a> <span class='layout'>}</span>
<a name="line-324"></a> <span class='layout'>,</span> <span class='varid'>res</span>
<a name="line-325"></a> <span class='layout'>)</span>
<a name="line-326"></a>
<a name="line-327"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-328"></a>
<a name="line-329"></a><span class='comment'>{- $system state params -}</span>
<a name="line-330"></a>
<a name="line-331"></a><a name="getSysParam"></a><span class='definition'>getSysParam</span> <span class='keyglyph'>::</span> <span class='layout'>(</span><span class='conid'>XIOSysState</span> <span class='keyglyph'>-></span> <span class='varid'>c</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-332"></a><span class='definition'>getSysParam</span> <span class='varid'>f</span>
<a name="line-333"></a> <span class='keyglyph'>=</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='sel'>_x</span> <span class='keyglyph'>-></span>
<a name="line-334"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>s</span><span class='layout'>,</span> <span class='layout'>(</span><span class='conop'>:</span><span class='conid'>[]</span><span class='layout'>)</span> <span class='varop'>.</span> <span class='varid'>f</span> <span class='varop'>.</span> <span class='varid'>xio_sysState</span> <span class='varop'>$</span> <span class='varid'>s</span><span class='layout'>)</span>
<a name="line-335"></a>
<a name="line-336"></a><a name="changeSysParam"></a><span class='definition'>changeSysParam</span> <span class='keyglyph'>::</span> <span class='layout'>(</span><span class='varid'>b</span> <span class='keyglyph'>-></span> <span class='conid'>XIOSysState</span> <span class='keyglyph'>-></span> <span class='conid'>XIOSysState</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-337"></a><span class='definition'>changeSysParam</span> <span class='varid'>cf</span>
<a name="line-338"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='varid'>v</span> <span class='keyglyph'>-></span>
<a name="line-339"></a> <span class='keyword'>let</span> <span class='varid'>s'</span> <span class='keyglyph'>=</span> <span class='varid'>changeSysState</span> <span class='layout'>(</span><span class='varid'>cf</span> <span class='varid'>v</span><span class='layout'>)</span> <span class='varid'>s</span>
<a name="line-340"></a> <span class='keyword'>in</span> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>s'</span><span class='layout'>,</span> <span class='keyglyph'>[</span><span class='varid'>v</span><span class='keyglyph'>]</span><span class='layout'>)</span>
<a name="line-341"></a> <span class='layout'>)</span>
<a name="line-342"></a> <span class='keyword'>where</span>
<a name="line-343"></a> <span class='varid'>changeSysState</span> <span class='varid'>css</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_sysState</span> <span class='keyglyph'>=</span> <span class='varid'>css</span> <span class='layout'>(</span><span class='varid'>xio_sysState</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='layout'>}</span>
<a name="line-344"></a>
<a name="line-345"></a><span class='comment'>-- | store a single XML tree in global state under a given attribute name</span>
<a name="line-346"></a>
<a name="line-347"></a><a name="setParam"></a><span class='definition'>setParam</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-348"></a><span class='definition'>setParam</span> <span class='varid'>n</span>
<a name="line-349"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span><span class='conop'>:</span><span class='conid'>[]</span><span class='layout'>)</span> <span class='varop'>^>></span> <span class='varid'>setParamList</span> <span class='varid'>n</span>
<a name="line-350"></a>
<a name="line-351"></a><span class='comment'>-- | store a list of XML trees in global system state under a given attribute name</span>
<a name="line-352"></a>
<a name="line-353"></a><a name="setParamList"></a><span class='definition'>setParamList</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTrees</span> <span class='conid'>XmlTree</span>
<a name="line-354"></a><span class='definition'>setParamList</span> <span class='varid'>n</span>
<a name="line-355"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>addE</span>
<a name="line-356"></a> <span class='varop'>>>></span>
<a name="line-357"></a> <span class='varid'>arrL</span> <span class='varid'>id</span>
<a name="line-358"></a> <span class='keyword'>where</span>
<a name="line-359"></a> <span class='varid'>addE</span> <span class='varid'>x</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_attrList</span> <span class='keyglyph'>=</span> <span class='varid'>addEntry</span> <span class='varid'>n</span> <span class='varid'>x</span> <span class='layout'>(</span><span class='varid'>xio_attrList</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='layout'>}</span>
<a name="line-360"></a>
<a name="line-361"></a><span class='comment'>-- | remove an entry in global state, arrow input remains unchanged</span>
<a name="line-362"></a>
<a name="line-363"></a><a name="unsetParam"></a><span class='definition'>unsetParam</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-364"></a><span class='definition'>unsetParam</span> <span class='varid'>n</span>
<a name="line-365"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>delE</span>
<a name="line-366"></a> <span class='keyword'>where</span>
<a name="line-367"></a> <span class='varid'>delE</span> <span class='keyword'>_</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_attrList</span> <span class='keyglyph'>=</span> <span class='varid'>delEntry</span> <span class='varid'>n</span> <span class='layout'>(</span><span class='varid'>xio_attrList</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='layout'>}</span>
<a name="line-368"></a>
<a name="line-369"></a><span class='comment'>-- | read an attribute value from global state</span>
<a name="line-370"></a>
<a name="line-371"></a><a name="getParam"></a><span class='definition'>getParam</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>XmlTree</span>
<a name="line-372"></a><span class='definition'>getParam</span> <span class='varid'>n</span>
<a name="line-373"></a> <span class='keyglyph'>=</span> <span class='varid'>getAllParams</span>
<a name="line-374"></a> <span class='varop'>>>></span>
<a name="line-375"></a> <span class='varid'>arrL</span> <span class='layout'>(</span><span class='varid'>lookup1</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-376"></a>
<a name="line-377"></a><span class='comment'>-- | read all attributes from global state</span>
<a name="line-378"></a>
<a name="line-379"></a><a name="getAllParams"></a><span class='definition'>getAllParams</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='layout'>(</span><span class='conid'>AssocList</span> <span class='conid'>String</span> <span class='conid'>XmlTrees</span><span class='layout'>)</span>
<a name="line-380"></a><span class='definition'>getAllParams</span>
<a name="line-381"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_attrList</span>
<a name="line-382"></a>
<a name="line-383"></a><a name="setParamString"></a><span class='definition'>setParamString</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-384"></a><span class='definition'>setParamString</span> <span class='varid'>n</span> <span class='varid'>v</span>
<a name="line-385"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>txt</span> <span class='varid'>v</span>
<a name="line-386"></a> <span class='varop'>>>></span>
<a name="line-387"></a> <span class='varid'>setParam</span> <span class='varid'>n</span>
<a name="line-388"></a> <span class='layout'>)</span>
<a name="line-389"></a>
<a name="line-390"></a><span class='comment'>-- | read a string value from global state,</span>
<a name="line-391"></a><span class='comment'>-- if parameter not set \"\" is returned</span>
<a name="line-392"></a>
<a name="line-393"></a><a name="getParamString"></a><span class='definition'>getParamString</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>String</span>
<a name="line-394"></a><span class='definition'>getParamString</span> <span class='varid'>n</span>
<a name="line-395"></a> <span class='keyglyph'>=</span> <span class='varid'>xshow</span> <span class='layout'>(</span><span class='varid'>getParam</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-396"></a>
<a name="line-397"></a><span class='comment'>-- | store an int value in global state</span>
<a name="line-398"></a>
<a name="line-399"></a><a name="setParamInt"></a><span class='definition'>setParamInt</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-400"></a><span class='definition'>setParamInt</span> <span class='varid'>n</span> <span class='varid'>v</span>
<a name="line-401"></a> <span class='keyglyph'>=</span> <span class='varid'>setParamString</span> <span class='varid'>n</span> <span class='layout'>(</span><span class='varid'>show</span> <span class='varid'>v</span><span class='layout'>)</span>
<a name="line-402"></a>
<a name="line-403"></a><span class='comment'>-- | read an int value from global state</span>
<a name="line-404"></a><span class='comment'>-- </span>
<a name="line-405"></a><span class='comment'>-- > getParamInt 0 myIntAttr</span>
<a name="line-406"></a>
<a name="line-407"></a><a name="getParamInt"></a><span class='definition'>getParamInt</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>Int</span>
<a name="line-408"></a><span class='definition'>getParamInt</span> <span class='varid'>def</span> <span class='varid'>n</span>
<a name="line-409"></a> <span class='keyglyph'>=</span> <span class='varid'>getParamString</span> <span class='varid'>n</span>
<a name="line-410"></a> <span class='varop'>>>^</span>
<a name="line-411"></a> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>x</span> <span class='keyglyph'>-></span> <span class='keyword'>if</span> <span class='varid'>null</span> <span class='varid'>x</span> <span class='keyword'>then</span> <span class='varid'>def</span> <span class='keyword'>else</span> <span class='varid'>read</span> <span class='varid'>x</span><span class='layout'>)</span>
<a name="line-412"></a>
<a name="line-413"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-414"></a>
<a name="line-415"></a><span class='comment'>-- | reset global error variable</span>
<a name="line-416"></a>
<a name="line-417"></a><a name="changeErrorStatus"></a><span class='definition'>changeErrorStatus</span> <span class='keyglyph'>::</span> <span class='layout'>(</span><span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>Int</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>Int</span> <span class='conid'>Int</span>
<a name="line-418"></a><span class='definition'>changeErrorStatus</span> <span class='varid'>f</span>
<a name="line-419"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>l</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_errorStatus</span> <span class='keyglyph'>=</span> <span class='varid'>f</span> <span class='varid'>l</span> <span class='layout'>(</span><span class='varid'>xio_errorStatus</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='layout'>}</span><span class='layout'>)</span>
<a name="line-420"></a>
<a name="line-421"></a><a name="clearErrStatus"></a><span class='definition'>clearErrStatus</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-422"></a><span class='definition'>clearErrStatus</span>
<a name="line-423"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span><span class='varid'>constA</span> <span class='num'>0</span> <span class='varop'>>>></span> <span class='varid'>changeErrorStatus</span> <span class='varid'>min</span><span class='layout'>)</span>
<a name="line-424"></a>
<a name="line-425"></a><span class='comment'>-- | set global error variable</span>
<a name="line-426"></a>
<a name="line-427"></a><a name="setErrStatus"></a><span class='definition'>setErrStatus</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>Int</span> <span class='conid'>Int</span>
<a name="line-428"></a><span class='definition'>setErrStatus</span>
<a name="line-429"></a> <span class='keyglyph'>=</span> <span class='varid'>changeErrorStatus</span> <span class='varid'>max</span>
<a name="line-430"></a>
<a name="line-431"></a><span class='comment'>-- | read current global error status</span>
<a name="line-432"></a>
<a name="line-433"></a><a name="getErrStatus"></a><span class='definition'>getErrStatus</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>Int</span>
<a name="line-434"></a><span class='definition'>getErrStatus</span>
<a name="line-435"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_errorStatus</span>
<a name="line-436"></a>
<a name="line-437"></a><span class='comment'>-- | raise the global error status level to that of the input tree</span>
<a name="line-438"></a>
<a name="line-439"></a><a name="setErrMsgStatus"></a><span class='definition'>setErrMsgStatus</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-440"></a><span class='definition'>setErrMsgStatus</span>
<a name="line-441"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>getErrorLevel</span>
<a name="line-442"></a> <span class='varop'>>>></span>
<a name="line-443"></a> <span class='varid'>setErrStatus</span>
<a name="line-444"></a> <span class='layout'>)</span>
<a name="line-445"></a>
<a name="line-446"></a><span class='comment'>-- | set the error message handler and the flag for collecting the errors</span>
<a name="line-447"></a>
<a name="line-448"></a><a name="setErrorMsgHandler"></a><span class='definition'>setErrorMsgHandler</span> <span class='keyglyph'>::</span> <span class='conid'>Bool</span> <span class='keyglyph'>-></span> <span class='layout'>(</span><span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IO</span> <span class='conid'>()</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-449"></a><span class='definition'>setErrorMsgHandler</span> <span class='varid'>c</span> <span class='varid'>f</span>
<a name="line-450"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>cf</span>
<a name="line-451"></a> <span class='keyword'>where</span>
<a name="line-452"></a> <span class='varid'>cf</span> <span class='keyword'>_</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_errorMsgHandler</span> <span class='keyglyph'>=</span> <span class='varid'>f</span>
<a name="line-453"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgCollect</span> <span class='keyglyph'>=</span> <span class='varid'>c</span> <span class='layout'>}</span>
<a name="line-454"></a>
<a name="line-455"></a><span class='comment'>-- | error message handler for output to stderr</span>
<a name="line-456"></a>
<a name="line-457"></a><a name="sysErrorMsg"></a><span class='definition'>sysErrorMsg</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-458"></a><span class='definition'>sysErrorMsg</span>
<a name="line-459"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>getErrorLevel</span> <span class='varop'>&&&</span> <span class='varid'>getErrorMsg</span>
<a name="line-460"></a> <span class='varop'>>>></span>
<a name="line-461"></a> <span class='varid'>arr</span> <span class='varid'>formatErrorMsg</span>
<a name="line-462"></a> <span class='varop'>>>></span>
<a name="line-463"></a> <span class='layout'>(</span> <span class='conid'>IOSLA</span> <span class='varop'>$</span> <span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='varid'>e</span> <span class='keyglyph'>-></span>
<a name="line-464"></a> <span class='keyword'>do</span>
<a name="line-465"></a> <span class='layout'>(</span><span class='varid'>xio_errorMsgHandler</span> <span class='varop'>.</span> <span class='varid'>xio_sysState</span> <span class='varop'>$</span> <span class='varid'>s</span><span class='layout'>)</span> <span class='varid'>e</span>
<a name="line-466"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>s</span><span class='layout'>,</span> <span class='varid'>undefined</span><span class='layout'>)</span>
<a name="line-467"></a> <span class='layout'>)</span>
<a name="line-468"></a> <span class='layout'>)</span>
<a name="line-469"></a> <span class='keyword'>where</span>
<a name="line-470"></a> <span class='varid'>formatErrorMsg</span> <span class='layout'>(</span><span class='varid'>level</span><span class='layout'>,</span> <span class='varid'>msg</span><span class='layout'>)</span> <span class='keyglyph'>=</span> <span class='str'>"\n"</span> <span class='varop'>++</span> <span class='varid'>errClass</span> <span class='varid'>level</span> <span class='varop'>++</span> <span class='str'>": "</span> <span class='varop'>++</span> <span class='varid'>msg</span>
<a name="line-471"></a> <span class='varid'>errClass</span> <span class='varid'>l</span>
<a name="line-472"></a> <span class='keyglyph'>=</span> <span class='varid'>fromMaybe</span> <span class='str'>"fatal error"</span> <span class='varop'>.</span> <span class='varid'>lookup</span> <span class='varid'>l</span> <span class='varop'>$</span> <span class='varid'>msgList</span>
<a name="line-473"></a> <span class='keyword'>where</span>
<a name="line-474"></a> <span class='varid'>msgList</span> <span class='keyglyph'>=</span> <span class='keyglyph'>[</span> <span class='layout'>(</span><span class='varid'>c_ok</span><span class='layout'>,</span> <span class='str'>"no error"</span><span class='layout'>)</span>
<a name="line-475"></a> <span class='layout'>,</span> <span class='layout'>(</span><span class='varid'>c_warn</span><span class='layout'>,</span> <span class='str'>"warning"</span><span class='layout'>)</span>
<a name="line-476"></a> <span class='layout'>,</span> <span class='layout'>(</span><span class='varid'>c_err</span><span class='layout'>,</span> <span class='str'>"error"</span><span class='layout'>)</span>
<a name="line-477"></a> <span class='layout'>,</span> <span class='layout'>(</span><span class='varid'>c_fatal</span><span class='layout'>,</span> <span class='str'>"fatal error"</span><span class='layout'>)</span>
<a name="line-478"></a> <span class='keyglyph'>]</span>
<a name="line-479"></a>
<a name="line-480"></a>
<a name="line-481"></a><span class='comment'>-- | the default error message handler: error output to stderr</span>
<a name="line-482"></a>
<a name="line-483"></a><a name="errorMsgStderr"></a><span class='definition'>errorMsgStderr</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-484"></a><span class='definition'>errorMsgStderr</span> <span class='keyglyph'>=</span> <span class='varid'>setErrorMsgHandler</span> <span class='conid'>False</span> <span class='layout'>(</span><span class='varid'>hPutStrLn</span> <span class='varid'>stderr</span><span class='layout'>)</span>
<a name="line-485"></a>
<a name="line-486"></a><span class='comment'>-- | error message handler for collecting errors</span>
<a name="line-487"></a>
<a name="line-488"></a><a name="errorMsgCollect"></a><span class='definition'>errorMsgCollect</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-489"></a><span class='definition'>errorMsgCollect</span> <span class='keyglyph'>=</span> <span class='varid'>setErrorMsgHandler</span> <span class='conid'>True</span> <span class='layout'>(</span><span class='varid'>const</span> <span class='varop'>$</span> <span class='varid'>return</span> <span class='conid'>()</span><span class='layout'>)</span>
<a name="line-490"></a>
<a name="line-491"></a><span class='comment'>-- | error message handler for output to stderr and collecting</span>
<a name="line-492"></a>
<a name="line-493"></a><a name="errorMsgStderrAndCollect"></a><span class='definition'>errorMsgStderrAndCollect</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-494"></a><span class='definition'>errorMsgStderrAndCollect</span> <span class='keyglyph'>=</span> <span class='varid'>setErrorMsgHandler</span> <span class='conid'>True</span> <span class='layout'>(</span><span class='varid'>hPutStrLn</span> <span class='varid'>stderr</span><span class='layout'>)</span>
<a name="line-495"></a>
<a name="line-496"></a><span class='comment'>-- | error message handler for ignoring errors</span>
<a name="line-497"></a>
<a name="line-498"></a><a name="errorMsgIgnore"></a><span class='definition'>errorMsgIgnore</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-499"></a><span class='definition'>errorMsgIgnore</span> <span class='keyglyph'>=</span> <span class='varid'>setErrorMsgHandler</span> <span class='conid'>False</span> <span class='layout'>(</span><span class='varid'>const</span> <span class='varop'>$</span> <span class='varid'>return</span> <span class='conid'>()</span><span class='layout'>)</span>
<a name="line-500"></a>
<a name="line-501"></a><span class='comment'>-- |</span>
<a name="line-502"></a><span class='comment'>-- if error messages are collected by the error handler for</span>
<a name="line-503"></a><span class='comment'>-- processing these messages by the calling application,</span>
<a name="line-504"></a><span class='comment'>-- this arrow reads the stored messages and clears the error message store</span>
<a name="line-505"></a>
<a name="line-506"></a><a name="getErrorMessages"></a><span class='definition'>getErrorMessages</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>XmlTree</span>
<a name="line-507"></a><span class='definition'>getErrorMessages</span>
<a name="line-508"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='layout'>(</span><span class='varid'>reverse</span> <span class='varop'>.</span> <span class='varid'>xio_errorMsgList</span><span class='layout'>)</span> <span class='comment'>-- reverse the list of errors</span>
<a name="line-509"></a> <span class='varop'>>>></span>
<a name="line-510"></a> <span class='varid'>clearErrorMsgList</span> <span class='comment'>-- clear the error list in the system state</span>
<a name="line-511"></a> <span class='varop'>>>></span>
<a name="line-512"></a> <span class='varid'>arrL</span> <span class='varid'>id</span>
<a name="line-513"></a>
<a name="line-514"></a><a name="clearErrorMsgList"></a><span class='definition'>clearErrorMsgList</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-515"></a><span class='definition'>clearErrorMsgList</span>
<a name="line-516"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='keyword'>_</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_errorMsgList</span> <span class='keyglyph'>=</span> <span class='conid'>[]</span> <span class='layout'>}</span> <span class='layout'>)</span>
<a name="line-517"></a>
<a name="line-518"></a><a name="addToErrorMsgList"></a><span class='definition'>addToErrorMsgList</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-519"></a><span class='definition'>addToErrorMsgList</span>
<a name="line-520"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>cf</span>
<a name="line-521"></a> <span class='keyword'>where</span>
<a name="line-522"></a> <span class='varid'>cf</span> <span class='varid'>t</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='keyword'>if</span> <span class='varid'>xio_errorMsgCollect</span> <span class='varid'>s</span>
<a name="line-523"></a> <span class='keyword'>then</span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_errorMsgList</span> <span class='keyglyph'>=</span> <span class='varid'>t</span> <span class='conop'>:</span> <span class='varid'>xio_errorMsgList</span> <span class='varid'>s</span> <span class='layout'>}</span>
<a name="line-524"></a> <span class='keyword'>else</span> <span class='varid'>s</span>
<a name="line-525"></a>
<a name="line-526"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-527"></a>
<a name="line-528"></a><span class='comment'>-- |</span>
<a name="line-529"></a><span class='comment'>-- filter error messages from input trees and issue errors</span>
<a name="line-530"></a>
<a name="line-531"></a><a name="filterErrorMsg"></a><span class='definition'>filterErrorMsg</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-532"></a><span class='definition'>filterErrorMsg</span>
<a name="line-533"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='varid'>setErrMsgStatus</span>
<a name="line-534"></a> <span class='varop'>>>></span>
<a name="line-535"></a> <span class='varid'>sysErrorMsg</span>
<a name="line-536"></a> <span class='varop'>>>></span>
<a name="line-537"></a> <span class='varid'>addToErrorMsgList</span>
<a name="line-538"></a> <span class='varop'>>>></span>
<a name="line-539"></a> <span class='varid'>none</span>
<a name="line-540"></a> <span class='layout'>)</span>
<a name="line-541"></a> <span class='varop'>`when`</span>
<a name="line-542"></a> <span class='varid'>isError</span>
<a name="line-543"></a>
<a name="line-544"></a><span class='comment'>-- | generate a warnig message</span>
<a name="line-545"></a>
<a name="line-546"></a><a name="issueWarn"></a><span class='definition'>issueWarn</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-547"></a><span class='definition'>issueWarn</span> <span class='varid'>msg</span> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span><span class='varid'>warn</span> <span class='varid'>msg</span> <span class='varop'>>>></span> <span class='varid'>filterErrorMsg</span><span class='layout'>)</span>
<a name="line-548"></a>
<a name="line-549"></a><a name="issueErr"></a><span class='comment'>-- | generate an error message</span>
<a name="line-550"></a><span class='definition'>issueErr</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-551"></a><span class='definition'>issueErr</span> <span class='varid'>msg</span> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span><span class='varid'>err</span> <span class='varid'>msg</span> <span class='varop'>>>></span> <span class='varid'>filterErrorMsg</span><span class='layout'>)</span>
<a name="line-552"></a>
<a name="line-553"></a><span class='comment'>-- | generate a fatal error message, e.g. document not found</span>
<a name="line-554"></a>
<a name="line-555"></a><a name="issueFatal"></a><span class='definition'>issueFatal</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-556"></a><span class='definition'>issueFatal</span> <span class='varid'>msg</span> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span><span class='varid'>fatal</span> <span class='varid'>msg</span> <span class='varop'>>>></span> <span class='varid'>filterErrorMsg</span><span class='layout'>)</span>
<a name="line-557"></a>
<a name="line-558"></a><span class='comment'>-- |</span>
<a name="line-559"></a><span class='comment'>-- add the error level and the module where the error occured</span>
<a name="line-560"></a><span class='comment'>-- to the attributes of a document root node and remove the children when level is greater or equal to 'c_err'.</span>
<a name="line-561"></a><span class='comment'>-- called by 'setDocumentStatusFromSystemState' when the system state indicates an error</span>
<a name="line-562"></a>
<a name="line-563"></a><a name="setDocumentStatus"></a><span class='definition'>setDocumentStatus</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-564"></a><span class='definition'>setDocumentStatus</span> <span class='varid'>level</span> <span class='varid'>msg</span>
<a name="line-565"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='varid'>addAttrl</span> <span class='layout'>(</span> <span class='varid'>sattr</span> <span class='varid'>a_status</span> <span class='layout'>(</span><span class='varid'>show</span> <span class='varid'>level</span><span class='layout'>)</span>
<a name="line-566"></a> <span class='varop'><+></span>
<a name="line-567"></a> <span class='varid'>sattr</span> <span class='varid'>a_module</span> <span class='varid'>msg</span>
<a name="line-568"></a> <span class='layout'>)</span>
<a name="line-569"></a> <span class='varop'>>>></span>
<a name="line-570"></a> <span class='layout'>(</span> <span class='keyword'>if</span> <span class='varid'>level</span> <span class='varop'>>=</span> <span class='varid'>c_err</span>
<a name="line-571"></a> <span class='keyword'>then</span> <span class='varid'>setChildren</span> <span class='conid'>[]</span>
<a name="line-572"></a> <span class='keyword'>else</span> <span class='varid'>this</span>
<a name="line-573"></a> <span class='layout'>)</span>
<a name="line-574"></a> <span class='layout'>)</span>
<a name="line-575"></a> <span class='varop'>`when`</span>
<a name="line-576"></a> <span class='varid'>isRoot</span>
<a name="line-577"></a>
<a name="line-578"></a><span class='comment'>-- |</span>
<a name="line-579"></a><span class='comment'>-- check whether the error level attribute in the system state</span>
<a name="line-580"></a><span class='comment'>-- is set to error, in this case the children of the document root are</span>
<a name="line-581"></a><span class='comment'>-- removed and the module name where the error occured and the error level are added as attributes with 'setDocumentStatus'</span>
<a name="line-582"></a><span class='comment'>-- else nothing is changed</span>
<a name="line-583"></a>
<a name="line-584"></a><a name="setDocumentStatusFromSystemState"></a><span class='definition'>setDocumentStatusFromSystemState</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-585"></a><span class='definition'>setDocumentStatusFromSystemState</span> <span class='varid'>msg</span>
<a name="line-586"></a> <span class='keyglyph'>=</span> <span class='varid'>setStatus</span> <span class='varop'>$<</span> <span class='varid'>getErrStatus</span>
<a name="line-587"></a> <span class='keyword'>where</span>
<a name="line-588"></a> <span class='varid'>setStatus</span> <span class='varid'>level</span>
<a name="line-589"></a> <span class='keyglyph'>|</span> <span class='varid'>level</span> <span class='varop'><=</span> <span class='varid'>c_warn</span> <span class='keyglyph'>=</span> <span class='varid'>this</span>
<a name="line-590"></a> <span class='keyglyph'>|</span> <span class='varid'>otherwise</span> <span class='keyglyph'>=</span> <span class='varid'>setDocumentStatus</span> <span class='varid'>level</span> <span class='varid'>msg</span>
<a name="line-591"></a>
<a name="line-592"></a>
<a name="line-593"></a><span class='comment'>-- |</span>
<a name="line-594"></a><span class='comment'>-- check whether tree is a document root and the status attribute has a value less than 'c_err'</span>
<a name="line-595"></a>
<a name="line-596"></a><a name="documentStatusOk"></a><span class='definition'>documentStatusOk</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowXml</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-597"></a><span class='definition'>documentStatusOk</span>
<a name="line-598"></a> <span class='keyglyph'>=</span> <span class='varid'>isRoot</span>
<a name="line-599"></a> <span class='varop'>>>></span>
<a name="line-600"></a> <span class='layout'>(</span> <span class='layout'>(</span><span class='varid'>getAttrValue</span> <span class='varid'>a_status</span>
<a name="line-601"></a> <span class='varop'>>>></span>
<a name="line-602"></a> <span class='varid'>isA</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>v</span> <span class='keyglyph'>-></span> <span class='varid'>null</span> <span class='varid'>v</span> <span class='varop'>||</span> <span class='layout'>(</span><span class='layout'>(</span><span class='varid'>read</span> <span class='varid'>v</span><span class='layout'>)</span><span class='keyglyph'>::</span><span class='conid'>Int</span><span class='layout'>)</span> <span class='varop'><=</span> <span class='varid'>c_warn</span><span class='layout'>)</span>
<a name="line-603"></a> <span class='layout'>)</span>
<a name="line-604"></a> <span class='varop'>`guards`</span>
<a name="line-605"></a> <span class='varid'>this</span>
<a name="line-606"></a> <span class='layout'>)</span>
<a name="line-607"></a>
<a name="line-608"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-609"></a>
<a name="line-610"></a><span class='comment'>-- | set the base URI of a document, used e.g. for reading includes, e.g. external entities,</span>
<a name="line-611"></a><span class='comment'>-- the input must be an absolute URI</span>
<a name="line-612"></a>
<a name="line-613"></a><a name="setBaseURI"></a><span class='definition'>setBaseURI</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-614"></a><span class='definition'>setBaseURI</span>
<a name="line-615"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>b</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_baseURI</span> <span class='keyglyph'>=</span> <span class='varid'>b</span> <span class='layout'>}</span> <span class='layout'>)</span>
<a name="line-616"></a> <span class='varop'>>>></span>
<a name="line-617"></a> <span class='varid'>traceString</span> <span class='num'>2</span> <span class='layout'>(</span><span class='layout'>(</span><span class='str'>"setBaseURI: new base URI is "</span> <span class='varop'>++</span><span class='layout'>)</span> <span class='varop'>.</span> <span class='varid'>show</span><span class='layout'>)</span>
<a name="line-618"></a>
<a name="line-619"></a><span class='comment'>-- | read the base URI from the globale state</span>
<a name="line-620"></a>
<a name="line-621"></a><a name="getBaseURI"></a><span class='definition'>getBaseURI</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>String</span>
<a name="line-622"></a><span class='definition'>getBaseURI</span>
<a name="line-623"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_baseURI</span>
<a name="line-624"></a> <span class='varop'>>>></span>
<a name="line-625"></a> <span class='layout'>(</span> <span class='layout'>(</span> <span class='varid'>getDefaultBaseURI</span>
<a name="line-626"></a> <span class='varop'>>>></span>
<a name="line-627"></a> <span class='varid'>setBaseURI</span>
<a name="line-628"></a> <span class='varop'>>>></span>
<a name="line-629"></a> <span class='varid'>getBaseURI</span>
<a name="line-630"></a> <span class='layout'>)</span>
<a name="line-631"></a> <span class='varop'>`when`</span>
<a name="line-632"></a> <span class='varid'>isA</span> <span class='varid'>null</span> <span class='comment'>-- set and get it, if not yet done</span>
<a name="line-633"></a> <span class='layout'>)</span>
<a name="line-634"></a>
<a name="line-635"></a><span class='comment'>-- | change the base URI with a possibly relative URI, can be used for</span>
<a name="line-636"></a><span class='comment'>-- evaluating the xml:base attribute. Returns the new absolute base URI.</span>
<a name="line-637"></a><span class='comment'>-- Fails, if input is not parsable with parseURIReference</span>
<a name="line-638"></a><span class='comment'>--</span>
<a name="line-639"></a><span class='comment'>-- see also: 'setBaseURI', 'mkAbsURI'</span>
<a name="line-640"></a>
<a name="line-641"></a><a name="changeBaseURI"></a><span class='definition'>changeBaseURI</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-642"></a><span class='definition'>changeBaseURI</span>
<a name="line-643"></a> <span class='keyglyph'>=</span> <span class='varid'>mkAbsURI</span>
<a name="line-644"></a> <span class='varop'>>>></span>
<a name="line-645"></a> <span class='varid'>setBaseURI</span>
<a name="line-646"></a>
<a name="line-647"></a><span class='comment'>-- | set the default base URI, if parameter is null, the system base (@ file:\/\/\/\<cwd\>\/ @) is used,</span>
<a name="line-648"></a><span class='comment'>-- else the parameter, must be called before any document is read</span>
<a name="line-649"></a>
<a name="line-650"></a><a name="setDefaultBaseURI"></a><span class='definition'>setDefaultBaseURI</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>String</span>
<a name="line-651"></a><span class='definition'>setDefaultBaseURI</span> <span class='varid'>base</span>
<a name="line-652"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='keyword'>if</span> <span class='varid'>null</span> <span class='varid'>base</span>
<a name="line-653"></a> <span class='keyword'>then</span> <span class='varid'>arrIO</span> <span class='varid'>getDir</span>
<a name="line-654"></a> <span class='keyword'>else</span> <span class='varid'>constA</span> <span class='varid'>base</span>
<a name="line-655"></a> <span class='layout'>)</span>
<a name="line-656"></a> <span class='varop'>>>></span>
<a name="line-657"></a> <span class='varid'>changeSysParam</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>b</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_defaultBaseURI</span> <span class='keyglyph'>=</span> <span class='varid'>b</span> <span class='layout'>}</span> <span class='layout'>)</span>
<a name="line-658"></a> <span class='varop'>>>></span>
<a name="line-659"></a> <span class='varid'>traceString</span> <span class='num'>2</span> <span class='layout'>(</span><span class='layout'>(</span><span class='str'>"setDefaultBaseURI: new default base URI is "</span> <span class='varop'>++</span><span class='layout'>)</span> <span class='varop'>.</span> <span class='varid'>show</span><span class='layout'>)</span>
<a name="line-660"></a> <span class='keyword'>where</span>
<a name="line-661"></a> <span class='varid'>getDir</span> <span class='keyword'>_</span> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-662"></a> <span class='varid'>cwd</span> <span class='keyglyph'><-</span> <span class='varid'>getCurrentDirectory</span>
<a name="line-663"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='str'>"file://"</span> <span class='varop'>++</span> <span class='varid'>normalize</span> <span class='varid'>cwd</span> <span class='varop'>++</span> <span class='str'>"/"</span><span class='layout'>)</span>
<a name="line-664"></a>
<a name="line-665"></a> <span class='comment'>-- under Windows getCurrentDirectory returns something like: "c:\path\to\file"</span>
<a name="line-666"></a> <span class='comment'>-- backslaches are not allowed in URIs and paths must start with a /</span>
<a name="line-667"></a> <span class='comment'>-- so this is transformed into "/c:/path/to/file"</span>
<a name="line-668"></a>
<a name="line-669"></a> <span class='varid'>normalize</span> <span class='varid'>wd'</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='varid'>d</span> <span class='conop'>:</span> <span class='chr'>':'</span> <span class='conop'>:</span> <span class='keyword'>_</span><span class='layout'>)</span>
<a name="line-670"></a> <span class='keyglyph'>|</span> <span class='varid'>d</span> <span class='varop'>`elem`</span> <span class='keyglyph'>[</span><span class='chr'>'A'</span><span class='keyglyph'>..</span><span class='chr'>'Z'</span><span class='keyglyph'>]</span> <span class='varop'>||</span> <span class='varid'>d</span> <span class='varop'>`elem`</span> <span class='keyglyph'>[</span><span class='chr'>'a'</span><span class='keyglyph'>..</span><span class='chr'>'z'</span><span class='keyglyph'>]</span>
<a name="line-671"></a> <span class='keyglyph'>=</span> <span class='chr'>'/'</span> <span class='conop'>:</span> <span class='varid'>concatMap</span> <span class='varid'>win32ToUriChar</span> <span class='varid'>wd'</span>
<a name="line-672"></a> <span class='varid'>normalize</span> <span class='varid'>wd'</span>
<a name="line-673"></a> <span class='keyglyph'>=</span> <span class='varid'>concatMap</span> <span class='varid'>escapeNonUriChar</span> <span class='varid'>wd'</span>
<a name="line-674"></a>
<a name="line-675"></a> <span class='varid'>win32ToUriChar</span> <span class='chr'>'\\'</span> <span class='keyglyph'>=</span> <span class='str'>"/"</span>
<a name="line-676"></a> <span class='varid'>win32ToUriChar</span> <span class='varid'>c</span> <span class='keyglyph'>=</span> <span class='varid'>escapeNonUriChar</span> <span class='varid'>c</span>
<a name="line-677"></a>
<a name="line-678"></a> <span class='varid'>escapeNonUriChar</span> <span class='varid'>c</span> <span class='keyglyph'>=</span> <span class='varid'>escapeURIChar</span> <span class='varid'>isUnescapedInURI</span> <span class='varid'>c</span> <span class='comment'>-- from Network.URI</span>
<a name="line-679"></a>
<a name="line-680"></a>
<a name="line-681"></a><span class='comment'>-- | get the default base URI</span>
<a name="line-682"></a>
<a name="line-683"></a><a name="getDefaultBaseURI"></a><span class='definition'>getDefaultBaseURI</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>String</span>
<a name="line-684"></a><span class='definition'>getDefaultBaseURI</span>
<a name="line-685"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_defaultBaseURI</span> <span class='comment'>-- read default uri in system state</span>
<a name="line-686"></a> <span class='varop'>>>></span>
<a name="line-687"></a> <span class='layout'>(</span> <span class='varid'>setDefaultBaseURI</span> <span class='str'>""</span> <span class='comment'>-- set the default uri in system state</span>
<a name="line-688"></a> <span class='varop'>>>></span>
<a name="line-689"></a> <span class='varid'>getDefaultBaseURI</span> <span class='layout'>)</span> <span class='varop'>`when`</span> <span class='varid'>isA</span> <span class='varid'>null</span> <span class='comment'>-- when uri not yet set</span>
<a name="line-690"></a>
<a name="line-691"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-692"></a>
<a name="line-693"></a><span class='comment'>-- | remember base uri, run an arrow and restore the base URI, used with external entity substitution</span>
<a name="line-694"></a>
<a name="line-695"></a><a name="runInLocalURIContext"></a><span class='definition'>runInLocalURIContext</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>c</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-696"></a><span class='definition'>runInLocalURIContext</span> <span class='varid'>f</span>
<a name="line-697"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='varid'>getBaseURI</span> <span class='varop'>&&&</span> <span class='varid'>this</span> <span class='layout'>)</span>
<a name="line-698"></a> <span class='varop'>>>></span>
<a name="line-699"></a> <span class='layout'>(</span> <span class='varid'>this</span> <span class='varop'>***</span> <span class='varid'>listA</span> <span class='varid'>f</span> <span class='layout'>)</span>
<a name="line-700"></a> <span class='varop'>>>></span>
<a name="line-701"></a> <span class='layout'>(</span> <span class='varid'>setBaseURI</span> <span class='varop'>***</span> <span class='varid'>this</span> <span class='layout'>)</span>
<a name="line-702"></a> <span class='varop'>>>></span>
<a name="line-703"></a> <span class='varid'>arrL</span> <span class='varid'>snd</span>
<a name="line-704"></a>
<a name="line-705"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-706"></a>
<a name="line-707"></a><span class='comment'>-- | set the global trace level</span>
<a name="line-708"></a>
<a name="line-709"></a><a name="setTraceLevel"></a><span class='definition'>setTraceLevel</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-710"></a><span class='definition'>setTraceLevel</span> <span class='varid'>l</span>
<a name="line-711"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='keyword'>_</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='varid'>s</span> <span class='layout'>{</span> <span class='varid'>xio_trace</span> <span class='keyglyph'>=</span> <span class='varid'>l</span> <span class='layout'>}</span> <span class='layout'>)</span>
<a name="line-712"></a>
<a name="line-713"></a><span class='comment'>-- | read the global trace level</span>
<a name="line-714"></a>
<a name="line-715"></a><a name="getTraceLevel"></a><span class='definition'>getTraceLevel</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>Int</span>
<a name="line-716"></a><span class='definition'>getTraceLevel</span>
<a name="line-717"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_trace</span>
<a name="line-718"></a>
<a name="line-719"></a><span class='comment'>-- | run an arrow with a given trace level, the old trace level is restored after the arrow execution</span>
<a name="line-720"></a>
<a name="line-721"></a><a name="withTraceLevel"></a><span class='definition'>withTraceLevel</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>c</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>c</span>
<a name="line-722"></a><span class='definition'>withTraceLevel</span> <span class='varid'>level</span> <span class='varid'>f</span>
<a name="line-723"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='varid'>getTraceLevel</span> <span class='varop'>&&&</span> <span class='varid'>this</span> <span class='layout'>)</span>
<a name="line-724"></a> <span class='varop'>>>></span>
<a name="line-725"></a> <span class='layout'>(</span> <span class='varid'>setTraceLevel</span> <span class='varid'>level</span> <span class='varop'>***</span> <span class='varid'>listA</span> <span class='varid'>f</span> <span class='layout'>)</span>
<a name="line-726"></a> <span class='varop'>>>></span>
<a name="line-727"></a> <span class='layout'>(</span> <span class='varid'>restoreTraceLevel</span> <span class='varop'>***</span> <span class='varid'>this</span> <span class='layout'>)</span>
<a name="line-728"></a> <span class='varop'>>>></span>
<a name="line-729"></a> <span class='varid'>arrL</span> <span class='varid'>snd</span>
<a name="line-730"></a> <span class='keyword'>where</span>
<a name="line-731"></a> <span class='varid'>restoreTraceLevel</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>Int</span> <span class='conid'>Int</span>
<a name="line-732"></a> <span class='varid'>restoreTraceLevel</span>
<a name="line-733"></a> <span class='keyglyph'>=</span> <span class='varid'>setTraceLevel</span> <span class='varop'>$<</span> <span class='varid'>this</span>
<a name="line-734"></a>
<a name="line-735"></a><span class='comment'>-- | apply a trace arrow and issue message to stderr</span>
<a name="line-736"></a>
<a name="line-737"></a><a name="trace"></a><span class='definition'>trace</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-738"></a><span class='definition'>trace</span> <span class='varid'>level</span> <span class='varid'>trc</span>
<a name="line-739"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>trc</span>
<a name="line-740"></a> <span class='varop'>>>></span>
<a name="line-741"></a> <span class='varid'>arrIO</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>s</span> <span class='keyglyph'>-></span> <span class='layout'>(</span> <span class='keyword'>do</span>
<a name="line-742"></a> <span class='varid'>hPutStrLn</span> <span class='varid'>stderr</span> <span class='varid'>s</span>
<a name="line-743"></a> <span class='varid'>hFlush</span> <span class='varid'>stderr</span>
<a name="line-744"></a> <span class='layout'>)</span>
<a name="line-745"></a> <span class='layout'>)</span>
<a name="line-746"></a> <span class='layout'>)</span>
<a name="line-747"></a> <span class='varop'>`when`</span> <span class='layout'>(</span> <span class='varid'>getTraceLevel</span>
<a name="line-748"></a> <span class='varop'>>>></span>
<a name="line-749"></a> <span class='varid'>isA</span> <span class='layout'>(</span><span class='varop'>>=</span> <span class='varid'>level</span><span class='layout'>)</span>
<a name="line-750"></a> <span class='layout'>)</span>
<a name="line-751"></a>
<a name="line-752"></a><a name="traceMsg"></a><span class='comment'>-- | issue a string message as trace </span>
<a name="line-753"></a><span class='definition'>traceMsg</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-754"></a><span class='definition'>traceMsg</span> <span class='varid'>level</span> <span class='varid'>msg</span>
<a name="line-755"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>trace</span> <span class='varid'>level</span> <span class='varop'>$</span>
<a name="line-756"></a> <span class='varid'>constA</span> <span class='layout'>(</span><span class='chr'>'-'</span> <span class='conop'>:</span> <span class='str'>"- ("</span> <span class='varop'>++</span> <span class='varid'>show</span> <span class='varid'>level</span> <span class='varop'>++</span> <span class='str'>") "</span> <span class='varop'>++</span> <span class='varid'>msg</span><span class='layout'>)</span>
<a name="line-757"></a> <span class='layout'>)</span>
<a name="line-758"></a>
<a name="line-759"></a><a name="traceString"></a><span class='comment'>-- | issue the string input of an arrow</span>
<a name="line-760"></a><span class='definition'>traceString</span> <span class='keyglyph'>::</span> <span class='conid'>Int</span> <span class='keyglyph'>-></span> <span class='layout'>(</span><span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>String</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-761"></a><span class='definition'>traceString</span> <span class='varid'>level</span> <span class='varid'>f</span>
<a name="line-762"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span><span class='varid'>applyA</span> <span class='layout'>(</span><span class='varid'>arr</span> <span class='varid'>f</span> <span class='varop'>>>></span> <span class='varid'>arr</span> <span class='layout'>(</span><span class='varid'>traceMsg</span> <span class='varid'>level</span><span class='layout'>)</span><span class='layout'>)</span><span class='layout'>)</span>
<a name="line-763"></a>
<a name="line-764"></a><span class='comment'>-- | issue the source representation of a document if trace level >= 3</span>
<a name="line-765"></a><span class='comment'>--</span>
<a name="line-766"></a><span class='comment'>-- for better readability the source is formated with indentDoc</span>
<a name="line-767"></a>
<a name="line-768"></a><a name="traceSource"></a><span class='definition'>traceSource</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-769"></a><span class='definition'>traceSource</span>
<a name="line-770"></a> <span class='keyglyph'>=</span> <span class='varid'>trace</span> <span class='num'>3</span> <span class='varop'>$</span>
<a name="line-771"></a> <span class='varid'>xshow</span>
<a name="line-772"></a> <span class='layout'>(</span> <span class='varid'>choiceA</span> <span class='keyglyph'>[</span> <span class='varid'>isRoot</span> <span class='conop'>:-></span> <span class='layout'>(</span> <span class='varid'>indentDoc</span>
<a name="line-773"></a> <span class='varop'>>>></span>
<a name="line-774"></a> <span class='varid'>getChildren</span>
<a name="line-775"></a> <span class='layout'>)</span>
<a name="line-776"></a> <span class='layout'>,</span> <span class='varid'>isElem</span> <span class='conop'>:-></span> <span class='layout'>(</span> <span class='varid'>root</span> <span class='conid'>[]</span> <span class='keyglyph'>[</span><span class='varid'>this</span><span class='keyglyph'>]</span>
<a name="line-777"></a> <span class='varop'>>>></span> <span class='varid'>indentDoc</span>
<a name="line-778"></a> <span class='varop'>>>></span> <span class='varid'>getChildren</span>
<a name="line-779"></a> <span class='varop'>>>></span> <span class='varid'>isElem</span>
<a name="line-780"></a> <span class='layout'>)</span>
<a name="line-781"></a> <span class='layout'>,</span> <span class='varid'>this</span> <span class='conop'>:-></span> <span class='varid'>this</span>
<a name="line-782"></a> <span class='keyglyph'>]</span>
<a name="line-783"></a> <span class='layout'>)</span>
<a name="line-784"></a>
<a name="line-785"></a><a name="traceTree"></a><span class='comment'>-- | issue the tree representation of a document if trace level >= 4</span>
<a name="line-786"></a><span class='definition'>traceTree</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-787"></a><span class='definition'>traceTree</span>
<a name="line-788"></a> <span class='keyglyph'>=</span> <span class='varid'>trace</span> <span class='num'>4</span> <span class='varop'>$</span>
<a name="line-789"></a> <span class='varid'>xshow</span> <span class='layout'>(</span> <span class='varid'>treeRepOfXmlDoc</span>
<a name="line-790"></a> <span class='varop'>>>></span>
<a name="line-791"></a> <span class='varid'>addHeadlineToXmlDoc</span>
<a name="line-792"></a> <span class='varop'>>>></span>
<a name="line-793"></a> <span class='varid'>getChildren</span>
<a name="line-794"></a> <span class='layout'>)</span>
<a name="line-795"></a>
<a name="line-796"></a><span class='comment'>-- | trace a main computation step</span>
<a name="line-797"></a><span class='comment'>-- issue a message when trace level >= 1, issue document source if level >= 3, issue tree when level is >= 4</span>
<a name="line-798"></a>
<a name="line-799"></a><a name="traceDoc"></a><span class='definition'>traceDoc</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>XmlTree</span> <span class='conid'>XmlTree</span>
<a name="line-800"></a><span class='definition'>traceDoc</span> <span class='varid'>msg</span>
<a name="line-801"></a> <span class='keyglyph'>=</span> <span class='varid'>traceMsg</span> <span class='num'>1</span> <span class='varid'>msg</span>
<a name="line-802"></a> <span class='varop'>>>></span>
<a name="line-803"></a> <span class='varid'>traceSource</span>
<a name="line-804"></a> <span class='varop'>>>></span>
<a name="line-805"></a> <span class='varid'>traceTree</span>
<a name="line-806"></a>
<a name="line-807"></a><span class='comment'>-- | trace the global state</span>
<a name="line-808"></a>
<a name="line-809"></a><a name="traceState"></a><span class='definition'>traceState</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='varid'>b</span> <span class='varid'>b</span>
<a name="line-810"></a><span class='definition'>traceState</span>
<a name="line-811"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>xshow</span> <span class='layout'>(</span> <span class='layout'>(</span><span class='varid'>getAllParams</span> <span class='varop'>>>.</span> <span class='varid'>concat</span><span class='layout'>)</span>
<a name="line-812"></a> <span class='varop'>>>></span>
<a name="line-813"></a> <span class='varid'>applyA</span> <span class='layout'>(</span><span class='varid'>arr</span> <span class='varid'>formatParam</span><span class='layout'>)</span>
<a name="line-814"></a> <span class='layout'>)</span>
<a name="line-815"></a> <span class='varop'>>>></span>
<a name="line-816"></a> <span class='varid'>traceString</span> <span class='num'>2</span> <span class='layout'>(</span><span class='str'>"global state:\n"</span> <span class='varop'>++</span><span class='layout'>)</span>
<a name="line-817"></a> <span class='layout'>)</span>
<a name="line-818"></a> <span class='keyword'>where</span>
<a name="line-819"></a> <span class='comment'>-- formatParam :: (String, XmlTrees) -> IOStateArrow s b1 XmlTree</span>
<a name="line-820"></a> <span class='varid'>formatParam</span> <span class='layout'>(</span><span class='varid'>n</span><span class='layout'>,</span> <span class='varid'>v</span><span class='layout'>)</span>
<a name="line-821"></a> <span class='keyglyph'>=</span> <span class='varid'>mkelem</span> <span class='str'>"param"</span> <span class='keyglyph'>[</span><span class='varid'>sattr</span> <span class='str'>"name"</span> <span class='varid'>n</span><span class='keyglyph'>]</span> <span class='keyglyph'>[</span><span class='varid'>arrL</span> <span class='layout'>(</span><span class='varid'>const</span> <span class='varid'>v</span><span class='layout'>)</span><span class='keyglyph'>]</span> <span class='varop'><+></span> <span class='varid'>txt</span> <span class='str'>"\n"</span>
<a name="line-822"></a>
<a name="line-823"></a><span class='comment'>-- ----------------------------------------------------------</span>
<a name="line-824"></a>
<a name="line-825"></a><span class='comment'>-- | compute the absolut URI for a given URI and a base URI</span>
<a name="line-826"></a>
<a name="line-827"></a><a name="expandURIString"></a><span class='definition'>expandURIString</span> <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>Maybe</span> <span class='conid'>String</span>
<a name="line-828"></a><span class='definition'>expandURIString</span> <span class='varid'>uri</span> <span class='varid'>base</span>
<a name="line-829"></a> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-830"></a> <span class='varid'>base'</span> <span class='keyglyph'><-</span> <span class='varid'>parseURIReference</span> <span class='varid'>base</span>
<a name="line-831"></a> <span class='varid'>uri'</span> <span class='keyglyph'><-</span> <span class='varid'>parseURIReference</span> <span class='varid'>uri</span>
<a name="line-832"></a> <span class='varid'>abs'</span> <span class='keyglyph'><-</span> <span class='varid'>nonStrictRelativeTo</span> <span class='varid'>uri'</span> <span class='varid'>base'</span>
<a name="line-833"></a> <span class='varid'>return</span> <span class='varop'>$</span> <span class='varid'>show</span> <span class='varid'>abs'</span>
<a name="line-834"></a>
<a name="line-835"></a><span class='comment'>-- | arrow variant of 'expandURIString', fails if 'expandURIString' returns Nothing</span>
<a name="line-836"></a>
<a name="line-837"></a><a name="expandURI"></a><span class='definition'>expandURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowXml</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='layout'>(</span><span class='conid'>String</span><span class='layout'>,</span> <span class='conid'>String</span><span class='layout'>)</span> <span class='conid'>String</span>
<a name="line-838"></a><span class='definition'>expandURI</span>
<a name="line-839"></a> <span class='keyglyph'>=</span> <span class='varid'>arrL</span> <span class='layout'>(</span><span class='varid'>maybeToList</span> <span class='varop'>.</span> <span class='varid'>uncurry</span> <span class='varid'>expandURIString</span><span class='layout'>)</span>
<a name="line-840"></a>
<a name="line-841"></a><span class='comment'>-- | arrow for expanding an input URI into an absolute URI using global base URI, fails if input is not a legal URI</span>
<a name="line-842"></a>
<a name="line-843"></a><a name="mkAbsURI"></a><span class='definition'>mkAbsURI</span> <span class='keyglyph'>::</span> <span class='conid'>IOStateArrow</span> <span class='varid'>s</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-844"></a><span class='definition'>mkAbsURI</span>
<a name="line-845"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='varid'>this</span> <span class='varop'>&&&</span> <span class='varid'>getBaseURI</span> <span class='layout'>)</span> <span class='varop'>>>></span> <span class='varid'>expandURI</span>
<a name="line-846"></a>
<a name="line-847"></a><span class='comment'>-- | arrow for selecting the scheme (protocol) of the URI, fails if input is not a legal URI.</span>
<a name="line-848"></a><span class='comment'>--</span>
<a name="line-849"></a><span class='comment'>-- See Network.URI for URI components</span>
<a name="line-850"></a>
<a name="line-851"></a><a name="getSchemeFromURI"></a><span class='definition'>getSchemeFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-852"></a><span class='definition'>getSchemeFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>scheme</span>
<a name="line-853"></a> <span class='keyword'>where</span>
<a name="line-854"></a> <span class='varid'>scheme</span> <span class='keyglyph'>=</span> <span class='varid'>init</span> <span class='varop'>.</span> <span class='varid'>uriScheme</span>
<a name="line-855"></a>
<a name="line-856"></a><span class='comment'>-- | arrow for selecting the registered name (host) of the URI, fails if input is not a legal URI</span>
<a name="line-857"></a>
<a name="line-858"></a><a name="getRegNameFromURI"></a><span class='definition'>getRegNameFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-859"></a><span class='definition'>getRegNameFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>host</span>
<a name="line-860"></a> <span class='keyword'>where</span>
<a name="line-861"></a> <span class='varid'>host</span> <span class='keyglyph'>=</span> <span class='varid'>maybe</span> <span class='str'>""</span> <span class='varid'>uriRegName</span> <span class='varop'>.</span> <span class='varid'>uriAuthority</span>
<a name="line-862"></a>
<a name="line-863"></a><span class='comment'>-- | arrow for selecting the port number of the URI without leading \':\', fails if input is not a legal URI</span>
<a name="line-864"></a>
<a name="line-865"></a><a name="getPortFromURI"></a><span class='definition'>getPortFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-866"></a><span class='definition'>getPortFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>port</span>
<a name="line-867"></a> <span class='keyword'>where</span>
<a name="line-868"></a> <span class='varid'>port</span> <span class='keyglyph'>=</span> <span class='varid'>dropWhile</span> <span class='layout'>(</span><span class='varop'>==</span><span class='chr'>':'</span><span class='layout'>)</span> <span class='varop'>.</span> <span class='varid'>maybe</span> <span class='str'>""</span> <span class='varid'>uriPort</span> <span class='varop'>.</span> <span class='varid'>uriAuthority</span>
<a name="line-869"></a>
<a name="line-870"></a><span class='comment'>-- | arrow for selecting the user info of the URI without trailing \'\@\', fails if input is not a legal URI</span>
<a name="line-871"></a>
<a name="line-872"></a><a name="getUserInfoFromURI"></a><span class='definition'>getUserInfoFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-873"></a><span class='definition'>getUserInfoFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>ui</span>
<a name="line-874"></a> <span class='keyword'>where</span>
<a name="line-875"></a> <span class='varid'>ui</span> <span class='keyglyph'>=</span> <span class='varid'>reverse</span> <span class='varop'>.</span> <span class='varid'>dropWhile</span> <span class='layout'>(</span><span class='varop'>==</span><span class='chr'>'@'</span><span class='layout'>)</span> <span class='varop'>.</span> <span class='varid'>reverse</span> <span class='varop'>.</span> <span class='varid'>maybe</span> <span class='str'>""</span> <span class='varid'>uriUserInfo</span> <span class='varop'>.</span> <span class='varid'>uriAuthority</span>
<a name="line-876"></a>
<a name="line-877"></a><span class='comment'>-- | arrow for computing the path component of an URI, fails if input is not a legal URI</span>
<a name="line-878"></a>
<a name="line-879"></a><a name="getPathFromURI"></a><span class='definition'>getPathFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-880"></a><span class='definition'>getPathFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>uriPath</span>
<a name="line-881"></a>
<a name="line-882"></a><span class='comment'>-- | arrow for computing the query component of an URI, fails if input is not a legal URI</span>
<a name="line-883"></a>
<a name="line-884"></a><a name="getQueryFromURI"></a><span class='definition'>getQueryFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-885"></a><span class='definition'>getQueryFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>uriQuery</span>
<a name="line-886"></a>
<a name="line-887"></a><span class='comment'>-- | arrow for computing the fragment component of an URI, fails if input is not a legal URI</span>
<a name="line-888"></a>
<a name="line-889"></a><a name="getFragmentFromURI"></a><span class='definition'>getFragmentFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-890"></a><span class='definition'>getFragmentFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>uriFragment</span>
<a name="line-891"></a>
<a name="line-892"></a><span class='comment'>-- | arrow for computing the path component of an URI, fails if input is not a legal URI</span>
<a name="line-893"></a>
<a name="line-894"></a><a name="getPartFromURI"></a><span class='definition'>getPartFromURI</span> <span class='keyglyph'>::</span> <span class='conid'>ArrowList</span> <span class='varid'>a</span> <span class='keyglyph'>=></span> <span class='layout'>(</span><span class='conid'>URI</span> <span class='keyglyph'>-></span> <span class='conid'>String</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='varid'>a</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-895"></a><span class='definition'>getPartFromURI</span> <span class='varid'>sel</span>
<a name="line-896"></a> <span class='keyglyph'>=</span> <span class='varid'>arrL</span> <span class='layout'>(</span><span class='varid'>maybeToList</span> <span class='varop'>.</span> <span class='varid'>getPart</span><span class='layout'>)</span>
<a name="line-897"></a> <span class='keyword'>where</span>
<a name="line-898"></a> <span class='varid'>getPart</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-899"></a> <span class='varid'>uri</span> <span class='keyglyph'><-</span> <span class='varid'>parseURIReference</span> <span class='varid'>s</span>
<a name="line-900"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>sel</span> <span class='varid'>uri</span><span class='layout'>)</span>
<a name="line-901"></a>
<a name="line-902"></a><span class='comment'>-- ------------------------------------------------------------</span>
</pre></body>
</html>