hxt-8.1.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'>getAllParamsString</span><span class='layout'>,</span>
<a name="line-63"></a> <span class='varid'>setParamString</span><span class='layout'>,</span>
<a name="line-64"></a> <span class='varid'>getParamString</span><span class='layout'>,</span>
<a name="line-65"></a> <span class='varid'>setParamInt</span><span class='layout'>,</span>
<a name="line-66"></a> <span class='varid'>getParamInt</span><span class='layout'>,</span>
<a name="line-67"></a>
<a name="line-68"></a> <span class='comment'>-- * Error Message Handling</span>
<a name="line-69"></a> <span class='varid'>clearErrStatus</span><span class='layout'>,</span>
<a name="line-70"></a> <span class='varid'>setErrStatus</span><span class='layout'>,</span>
<a name="line-71"></a> <span class='varid'>getErrStatus</span><span class='layout'>,</span>
<a name="line-72"></a> <span class='varid'>setErrMsgStatus</span><span class='layout'>,</span>
<a name="line-73"></a> <span class='varid'>setErrorMsgHandler</span><span class='layout'>,</span>
<a name="line-74"></a>
<a name="line-75"></a> <span class='varid'>errorMsgStderr</span><span class='layout'>,</span>
<a name="line-76"></a> <span class='varid'>errorMsgCollect</span><span class='layout'>,</span>
<a name="line-77"></a> <span class='varid'>errorMsgStderrAndCollect</span><span class='layout'>,</span>
<a name="line-78"></a> <span class='varid'>errorMsgIgnore</span><span class='layout'>,</span>
<a name="line-79"></a>
<a name="line-80"></a> <span class='varid'>getErrorMessages</span><span class='layout'>,</span>
<a name="line-81"></a>
<a name="line-82"></a> <span class='varid'>filterErrorMsg</span><span class='layout'>,</span>
<a name="line-83"></a> <span class='varid'>issueWarn</span><span class='layout'>,</span>
<a name="line-84"></a> <span class='varid'>issueErr</span><span class='layout'>,</span>
<a name="line-85"></a> <span class='varid'>issueFatal</span><span class='layout'>,</span>
<a name="line-86"></a> <span class='varid'>setDocumentStatus</span><span class='layout'>,</span>
<a name="line-87"></a> <span class='varid'>setDocumentStatusFromSystemState</span><span class='layout'>,</span>
<a name="line-88"></a> <span class='varid'>documentStatusOk</span><span class='layout'>,</span>
<a name="line-89"></a>
<a name="line-90"></a> <span class='comment'>-- * Document Base</span>
<a name="line-91"></a> <span class='varid'>setBaseURI</span><span class='layout'>,</span>
<a name="line-92"></a> <span class='varid'>getBaseURI</span><span class='layout'>,</span>
<a name="line-93"></a> <span class='varid'>changeBaseURI</span><span class='layout'>,</span>
<a name="line-94"></a> <span class='varid'>setDefaultBaseURI</span><span class='layout'>,</span>
<a name="line-95"></a> <span class='varid'>getDefaultBaseURI</span><span class='layout'>,</span>
<a name="line-96"></a> <span class='varid'>runInLocalURIContext</span><span class='layout'>,</span>
<a name="line-97"></a>
<a name="line-98"></a> <span class='comment'>-- * Tracing</span>
<a name="line-99"></a> <span class='varid'>setTraceLevel</span><span class='layout'>,</span>
<a name="line-100"></a> <span class='varid'>getTraceLevel</span><span class='layout'>,</span>
<a name="line-101"></a> <span class='varid'>withTraceLevel</span><span class='layout'>,</span>
<a name="line-102"></a> <span class='varid'>trace</span><span class='layout'>,</span>
<a name="line-103"></a> <span class='varid'>traceMsg</span><span class='layout'>,</span>
<a name="line-104"></a> <span class='varid'>traceString</span><span class='layout'>,</span>
<a name="line-105"></a> <span class='varid'>traceSource</span><span class='layout'>,</span>
<a name="line-106"></a> <span class='varid'>traceTree</span><span class='layout'>,</span>
<a name="line-107"></a> <span class='varid'>traceDoc</span><span class='layout'>,</span>
<a name="line-108"></a> <span class='varid'>traceState</span><span class='layout'>,</span>
<a name="line-109"></a>
<a name="line-110"></a> <span class='comment'>-- * URI Manipulation</span>
<a name="line-111"></a> <span class='varid'>expandURIString</span><span class='layout'>,</span>
<a name="line-112"></a> <span class='varid'>expandURI</span><span class='layout'>,</span>
<a name="line-113"></a> <span class='varid'>mkAbsURI</span><span class='layout'>,</span>
<a name="line-114"></a>
<a name="line-115"></a> <span class='varid'>getFragmentFromURI</span><span class='layout'>,</span>
<a name="line-116"></a> <span class='varid'>getPathFromURI</span><span class='layout'>,</span>
<a name="line-117"></a> <span class='varid'>getPortFromURI</span><span class='layout'>,</span>
<a name="line-118"></a> <span class='varid'>getQueryFromURI</span><span class='layout'>,</span>
<a name="line-119"></a> <span class='varid'>getRegNameFromURI</span><span class='layout'>,</span>
<a name="line-120"></a> <span class='varid'>getSchemeFromURI</span><span class='layout'>,</span>
<a name="line-121"></a> <span class='varid'>getUserInfoFromURI</span><span class='layout'>,</span>
<a name="line-122"></a>
<a name="line-123"></a> <span class='comment'>-- * Mime Type Handling</span>
<a name="line-124"></a> <span class='varid'>setMimeTypeTable</span><span class='layout'>,</span>
<a name="line-125"></a> <span class='varid'>setMimeTypeTableFromFile</span>
<a name="line-126"></a> <span class='layout'>)</span>
<a name="line-127"></a><span class='keyword'>where</span>
<a name="line-128"></a>
<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='comment'>-- arrow classes</span>
<a name="line-130"></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-131"></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-132"></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-133"></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-134"></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-135"></a>
<a name="line-136"></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-137"></a>
<a name="line-138"></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-139"></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-140"></a>
<a name="line-141"></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-142"></a> <span class='layout'>(</span> <span class='varid'>addHeadlineToXmlDoc</span>
<a name="line-143"></a> <span class='layout'>,</span> <span class='varid'>treeRepOfXmlDoc</span>
<a name="line-144"></a> <span class='layout'>,</span> <span class='varid'>indentDoc</span>
<a name="line-145"></a> <span class='layout'>)</span>
<a name="line-146"></a>
<a name="line-147"></a><span class='keyword'>import</span> <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>Maybe</span>
<a name="line-148"></a>
<a name="line-149"></a><span class='keyword'>import</span> <span class='conid'>Network</span><span class='varop'>.</span><span class='conid'>URI</span>
<a name="line-150"></a> <span class='layout'>(</span> <span class='conid'>URI</span>
<a name="line-151"></a> <span class='layout'>,</span> <span class='varid'>escapeURIChar</span>
<a name="line-152"></a> <span class='layout'>,</span> <span class='varid'>isUnescapedInURI</span>
<a name="line-153"></a> <span class='layout'>,</span> <span class='varid'>nonStrictRelativeTo</span>
<a name="line-154"></a> <span class='layout'>,</span> <span class='varid'>parseURIReference</span>
<a name="line-155"></a> <span class='layout'>,</span> <span class='varid'>uriAuthority</span>
<a name="line-156"></a> <span class='layout'>,</span> <span class='varid'>uriFragment</span>
<a name="line-157"></a> <span class='layout'>,</span> <span class='varid'>uriPath</span>
<a name="line-158"></a> <span class='layout'>,</span> <span class='varid'>uriPort</span>
<a name="line-159"></a> <span class='layout'>,</span> <span class='varid'>uriQuery</span>
<a name="line-160"></a> <span class='layout'>,</span> <span class='varid'>uriRegName</span>
<a name="line-161"></a> <span class='layout'>,</span> <span class='varid'>uriScheme</span>
<a name="line-162"></a> <span class='layout'>,</span> <span class='varid'>uriUserInfo</span>
<a name="line-163"></a> <span class='layout'>)</span>
<a name="line-164"></a>
<a name="line-165"></a><span class='keyword'>import</span> <span class='conid'>System</span><span class='varop'>.</span><span class='conid'>IO</span>
<a name="line-166"></a> <span class='layout'>(</span> <span class='varid'>hPutStrLn</span>
<a name="line-167"></a> <span class='layout'>,</span> <span class='varid'>hFlush</span>
<a name="line-168"></a> <span class='layout'>,</span> <span class='varid'>stderr</span>
<a name="line-169"></a> <span class='layout'>)</span>
<a name="line-170"></a>
<a name="line-171"></a><span class='keyword'>import</span> <span class='conid'>System</span><span class='varop'>.</span><span class='conid'>Directory</span>
<a name="line-172"></a> <span class='layout'>(</span> <span class='varid'>getCurrentDirectory</span>
<a name="line-173"></a> <span class='layout'>)</span>
<a name="line-174"></a>
<a name="line-175"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-176"></a><span class='comment'>{- $datatypes -}</span>
<a name="line-177"></a>
<a name="line-178"></a>
<a name="line-179"></a><span class='comment'>-- |</span>
<a name="line-180"></a><span class='comment'>-- predefined system state data type with all components for the</span>
<a name="line-181"></a><span class='comment'>-- system functions, like trace, error handling, ...</span>
<a name="line-182"></a>
<a name="line-183"></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-184"></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-185"></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-186"></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-187"></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-188"></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-189"></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-190"></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-191"></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-192"></a> <span class='layout'>,</span> <span class='varid'>xio_mimeTypes</span> <span class='keyglyph'>::</span> <span class='conid'>MimeTypeTable</span>
<a name="line-193"></a> <span class='layout'>}</span>
<a name="line-194"></a>
<a name="line-195"></a><span class='keyword'>instance</span> <span class='conid'>DeepSeq</span> <span class='conid'>XIOSysState</span> <span class='keyword'>where</span>
<a name="line-196"></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='sel'>_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='sel'>_mt</span><span class='layout'>)</span> <span class='varid'>y</span>
<a name="line-197"></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'>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-198"></a>
<a name="line-199"></a><span class='comment'>-- |</span>
<a name="line-200"></a><span class='comment'>-- state datatype consists of a system state and a user state</span>
<a name="line-201"></a><span class='comment'>-- the user state is not fixed</span>
<a name="line-202"></a>
<a name="line-203"></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-204"></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-205"></a> <span class='layout'>}</span>
<a name="line-206"></a>
<a name="line-207"></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-208"></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-209"></a>
<a name="line-210"></a><span class='comment'>-- |</span>
<a name="line-211"></a><span class='comment'>-- The arrow type for stateful arrows</span>
<a name="line-212"></a>
<a name="line-213"></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-214"></a>
<a name="line-215"></a><span class='comment'>-- |</span>
<a name="line-216"></a><span class='comment'>-- The arrow for stateful arrows with no user defined state</span>
<a name="line-217"></a>
<a name="line-218"></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-219"></a>
<a name="line-220"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-221"></a>
<a name="line-222"></a>
<a name="line-223"></a><span class='comment'>-- | the default global state, used as initial state when running an 'IOSArrow' with 'runIOSLA' or</span>
<a name="line-224"></a><span class='comment'>-- 'runX'</span>
<a name="line-225"></a>
<a name="line-226"></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-227"></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-228"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>s</span>
<a name="line-229"></a> <span class='layout'>}</span>
<a name="line-230"></a>
<a name="line-231"></a><a name="initialSysState"></a><span class='definition'>initialSysState</span> <span class='keyglyph'>::</span> <span class='conid'>XIOSysState</span>
<a name="line-232"></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-233"></a> <span class='layout'>,</span> <span class='varid'>xio_errorStatus</span> <span class='keyglyph'>=</span> <span class='varid'>c_ok</span>
<a name="line-234"></a> <span class='layout'>,</span> <span class='varid'>xio_errorModule</span> <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-235"></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-236"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgCollect</span> <span class='keyglyph'>=</span> <span class='conid'>False</span>
<a name="line-237"></a> <span class='layout'>,</span> <span class='varid'>xio_errorMsgList</span> <span class='keyglyph'>=</span> <span class='conid'>[]</span>
<a name="line-238"></a> <span class='layout'>,</span> <span class='varid'>xio_baseURI</span> <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-239"></a> <span class='layout'>,</span> <span class='varid'>xio_defaultBaseURI</span> <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-240"></a> <span class='layout'>,</span> <span class='varid'>xio_attrList</span> <span class='keyglyph'>=</span> <span class='conid'>[]</span>
<a name="line-241"></a> <span class='layout'>,</span> <span class='varid'>xio_mimeTypes</span> <span class='keyglyph'>=</span> <span class='varid'>defaultMimeTypeTable</span>
<a name="line-242"></a> <span class='layout'>}</span>
<a name="line-243"></a>
<a name="line-244"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-245"></a>
<a name="line-246"></a><span class='comment'>-- |</span>
<a name="line-247"></a><span class='comment'>-- apply an 'IOSArrow' to an empty root node with 'initialState' () as initial state</span>
<a name="line-248"></a><span class='comment'>--</span>
<a name="line-249"></a><span class='comment'>-- the main entry point for running a state arrow with IO</span>
<a name="line-250"></a><span class='comment'>--</span>
<a name="line-251"></a><span class='comment'>-- when running @ runX f@ an empty XML root node is applied to @f@.</span>
<a name="line-252"></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-253"></a><span class='comment'>--</span>
<a name="line-254"></a><span class='comment'>-- for usage see examples with 'Text.XML.HXT.Arrow.WriteDocument.writeDocument'</span>
<a name="line-255"></a><span class='comment'>--</span>
<a name="line-256"></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-257"></a>
<a name="line-258"></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-259"></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-260"></a>
<a name="line-261"></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-262"></a><span class='definition'>runXIOState</span> <span class='varid'>s0</span> <span class='varid'>f</span>
<a name="line-263"></a> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-264"></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-265"></a> <span class='varid'>return</span> <span class='varid'>res</span>
<a name="line-266"></a> <span class='keyword'>where</span>
<a name="line-267"></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-268"></a>
<a name="line-269"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-270"></a>
<a name="line-271"></a><span class='comment'>{- user state -}</span>
<a name="line-272"></a>
<a name="line-273"></a><span class='comment'>-- | read the user defined part of the state</span>
<a name="line-274"></a>
<a name="line-275"></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-276"></a><span class='definition'>getUserState</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='keyword'>_</span> <span class='keyglyph'>-></span>
<a name="line-278"></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-279"></a>
<a name="line-280"></a><span class='comment'>-- | change the user defined part of the state</span>
<a name="line-281"></a>
<a name="line-282"></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-283"></a><span class='definition'>changeUserState</span> <span class='varid'>cf</span>
<a name="line-284"></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-285"></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-286"></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-287"></a>
<a name="line-288"></a><span class='comment'>-- | set the user defined part of the state</span>
<a name="line-289"></a>
<a name="line-290"></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-291"></a><span class='definition'>setUserState</span>
<a name="line-292"></a> <span class='keyglyph'>=</span> <span class='varid'>changeUserState</span> <span class='varid'>const</span>
<a name="line-293"></a>
<a name="line-294"></a><span class='comment'>-- | extend user state</span>
<a name="line-295"></a><span class='comment'>--</span>
<a name="line-296"></a><span class='comment'>-- Run an arrow with an extended user state component, The old component</span>
<a name="line-297"></a><span class='comment'>-- is stored together with a new one in a pair, the arrow is executed with this</span>
<a name="line-298"></a><span class='comment'>-- extended state, and the augmented state component is removed form the state</span>
<a name="line-299"></a><span class='comment'>-- when the arrow has finished its execution</span>
<a name="line-300"></a>
<a name="line-301"></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-302"></a><span class='definition'>withExtendedUserState</span> <span class='varid'>initS1</span> <span class='varid'>f</span>
<a name="line-303"></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-304"></a> <span class='keyword'>do</span>
<a name="line-305"></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-306"></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-307"></a> <span class='layout'>}</span>
<a name="line-308"></a> <span class='layout'>)</span> <span class='varid'>x</span>
<a name="line-309"></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-310"></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-311"></a> <span class='layout'>}</span>
<a name="line-312"></a> <span class='layout'>,</span> <span class='varid'>res</span>
<a name="line-313"></a> <span class='layout'>)</span>
<a name="line-314"></a>
<a name="line-315"></a><span class='comment'>-- | change the type of user state</span>
<a name="line-316"></a><span class='comment'>--</span>
<a name="line-317"></a><span class='comment'>-- This conversion is useful, when running a state arrow with another</span>
<a name="line-318"></a><span class='comment'>-- structure of the user state, e.g. with () when executing some IO arrows</span>
<a name="line-319"></a>
<a name="line-320"></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-321"></a><span class='definition'>withOtherUserState</span> <span class='varid'>s1</span> <span class='varid'>f</span>
<a name="line-322"></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-323"></a> <span class='keyword'>do</span>
<a name="line-324"></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-325"></a> <span class='layout'>,</span> <span class='varid'>xio_userState</span> <span class='keyglyph'>=</span> <span class='varid'>s1</span>
<a name="line-326"></a> <span class='layout'>}</span>
<a name="line-327"></a> <span class='layout'>)</span> <span class='varid'>x</span>
<a name="line-328"></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-329"></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-330"></a> <span class='layout'>}</span>
<a name="line-331"></a> <span class='layout'>,</span> <span class='varid'>res</span>
<a name="line-332"></a> <span class='layout'>)</span>
<a name="line-333"></a>
<a name="line-334"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-335"></a>
<a name="line-336"></a><span class='comment'>{- $system state params -}</span>
<a name="line-337"></a>
<a name="line-338"></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-339"></a><span class='definition'>getSysParam</span> <span class='varid'>f</span>
<a name="line-340"></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-341"></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-342"></a>
<a name="line-343"></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-344"></a><span class='definition'>changeSysParam</span> <span class='varid'>cf</span>
<a name="line-345"></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-346"></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-347"></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-348"></a> <span class='layout'>)</span>
<a name="line-349"></a> <span class='keyword'>where</span>
<a name="line-350"></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-351"></a>
<a name="line-352"></a><span class='comment'>-- | store a single XML tree in global state under a given attribute name</span>
<a name="line-353"></a>
<a name="line-354"></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-355"></a><span class='definition'>setParam</span> <span class='varid'>n</span>
<a name="line-356"></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-357"></a>
<a name="line-358"></a><span class='comment'>-- | store a list of XML trees in global system state under a given attribute name</span>
<a name="line-359"></a>
<a name="line-360"></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-361"></a><span class='definition'>setParamList</span> <span class='varid'>n</span>
<a name="line-362"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>addE</span>
<a name="line-363"></a> <span class='varop'>>>></span>
<a name="line-364"></a> <span class='varid'>arrL</span> <span class='varid'>id</span>
<a name="line-365"></a> <span class='keyword'>where</span>
<a name="line-366"></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-367"></a>
<a name="line-368"></a><span class='comment'>-- | remove an entry in global state, arrow input remains unchanged</span>
<a name="line-369"></a>
<a name="line-370"></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-371"></a><span class='definition'>unsetParam</span> <span class='varid'>n</span>
<a name="line-372"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>delE</span>
<a name="line-373"></a> <span class='keyword'>where</span>
<a name="line-374"></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-375"></a>
<a name="line-376"></a><span class='comment'>-- | read an attribute value from global state</span>
<a name="line-377"></a>
<a name="line-378"></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-379"></a><span class='definition'>getParam</span> <span class='varid'>n</span>
<a name="line-380"></a> <span class='keyglyph'>=</span> <span class='varid'>getAllParams</span>
<a name="line-381"></a> <span class='varop'>>>></span>
<a name="line-382"></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-383"></a>
<a name="line-384"></a><span class='comment'>-- | read all attributes from global state</span>
<a name="line-385"></a>
<a name="line-386"></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-387"></a><span class='definition'>getAllParams</span>
<a name="line-388"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_attrList</span>
<a name="line-389"></a>
<a name="line-390"></a><span class='comment'>-- | read all attributes from global state</span>
<a name="line-391"></a><span class='comment'>-- and convert the values to strings</span>
<a name="line-392"></a>
<a name="line-393"></a><a name="getAllParamsString"></a><span class='definition'>getAllParamsString</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'>String</span><span class='layout'>)</span>
<a name="line-394"></a><span class='definition'>getAllParamsString</span>
<a name="line-395"></a> <span class='keyglyph'>=</span> <span class='varid'>getAllParams</span>
<a name="line-396"></a> <span class='varop'>>>></span>
<a name="line-397"></a> <span class='varid'>listA</span> <span class='layout'>(</span> <span class='varid'>unlistA</span>
<a name="line-398"></a> <span class='varop'>>>></span>
<a name="line-399"></a> <span class='varid'>second</span> <span class='layout'>(</span><span class='varid'>xshow</span> <span class='varid'>unlistA</span><span class='layout'>)</span>
<a name="line-400"></a> <span class='layout'>)</span>
<a name="line-401"></a>
<a name="line-402"></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-403"></a><span class='definition'>setParamString</span> <span class='varid'>n</span> <span class='varid'>v</span>
<a name="line-404"></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-405"></a> <span class='varop'>>>></span>
<a name="line-406"></a> <span class='varid'>setParam</span> <span class='varid'>n</span>
<a name="line-407"></a> <span class='layout'>)</span>
<a name="line-408"></a>
<a name="line-409"></a><span class='comment'>-- | read a string value from global state,</span>
<a name="line-410"></a><span class='comment'>-- if parameter not set \"\" is returned</span>
<a name="line-411"></a>
<a name="line-412"></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-413"></a><span class='definition'>getParamString</span> <span class='varid'>n</span>
<a name="line-414"></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-415"></a>
<a name="line-416"></a><span class='comment'>-- | store an int value in global state</span>
<a name="line-417"></a>
<a name="line-418"></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-419"></a><span class='definition'>setParamInt</span> <span class='varid'>n</span> <span class='varid'>v</span>
<a name="line-420"></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-421"></a>
<a name="line-422"></a><span class='comment'>-- | read an int value from global state</span>
<a name="line-423"></a><span class='comment'>-- </span>
<a name="line-424"></a><span class='comment'>-- > getParamInt 0 myIntAttr</span>
<a name="line-425"></a>
<a name="line-426"></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-427"></a><span class='definition'>getParamInt</span> <span class='varid'>def</span> <span class='varid'>n</span>
<a name="line-428"></a> <span class='keyglyph'>=</span> <span class='varid'>getParamString</span> <span class='varid'>n</span>
<a name="line-429"></a> <span class='varop'>>>^</span>
<a name="line-430"></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-431"></a>
<a name="line-432"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-433"></a>
<a name="line-434"></a><span class='comment'>-- | reset global error variable</span>
<a name="line-435"></a>
<a name="line-436"></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-437"></a><span class='definition'>changeErrorStatus</span> <span class='varid'>f</span>
<a name="line-438"></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-439"></a>
<a name="line-440"></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-441"></a><span class='definition'>clearErrStatus</span>
<a name="line-442"></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-443"></a>
<a name="line-444"></a><span class='comment'>-- | set global error variable</span>
<a name="line-445"></a>
<a name="line-446"></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-447"></a><span class='definition'>setErrStatus</span>
<a name="line-448"></a> <span class='keyglyph'>=</span> <span class='varid'>changeErrorStatus</span> <span class='varid'>max</span>
<a name="line-449"></a>
<a name="line-450"></a><span class='comment'>-- | read current global error status</span>
<a name="line-451"></a>
<a name="line-452"></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-453"></a><span class='definition'>getErrStatus</span>
<a name="line-454"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_errorStatus</span>
<a name="line-455"></a>
<a name="line-456"></a><span class='comment'>-- | raise the global error status level to that of the input tree</span>
<a name="line-457"></a>
<a name="line-458"></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-459"></a><span class='definition'>setErrMsgStatus</span>
<a name="line-460"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>getErrorLevel</span>
<a name="line-461"></a> <span class='varop'>>>></span>
<a name="line-462"></a> <span class='varid'>setErrStatus</span>
<a name="line-463"></a> <span class='layout'>)</span>
<a name="line-464"></a>
<a name="line-465"></a><span class='comment'>-- | set the error message handler and the flag for collecting the errors</span>
<a name="line-466"></a>
<a name="line-467"></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-468"></a><span class='definition'>setErrorMsgHandler</span> <span class='varid'>c</span> <span class='varid'>f</span>
<a name="line-469"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>cf</span>
<a name="line-470"></a> <span class='keyword'>where</span>
<a name="line-471"></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-472"></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-473"></a>
<a name="line-474"></a><span class='comment'>-- | error message handler for output to stderr</span>
<a name="line-475"></a>
<a name="line-476"></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-477"></a><span class='definition'>sysErrorMsg</span>
<a name="line-478"></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-479"></a> <span class='varop'>>>></span>
<a name="line-480"></a> <span class='varid'>arr</span> <span class='varid'>formatErrorMsg</span>
<a name="line-481"></a> <span class='varop'>>>></span>
<a name="line-482"></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-483"></a> <span class='keyword'>do</span>
<a name="line-484"></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-485"></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-486"></a> <span class='layout'>)</span>
<a name="line-487"></a> <span class='layout'>)</span>
<a name="line-488"></a> <span class='keyword'>where</span>
<a name="line-489"></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-490"></a> <span class='varid'>errClass</span> <span class='varid'>l</span>
<a name="line-491"></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-492"></a> <span class='keyword'>where</span>
<a name="line-493"></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-494"></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-495"></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-496"></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-497"></a> <span class='keyglyph'>]</span>
<a name="line-498"></a>
<a name="line-499"></a>
<a name="line-500"></a><span class='comment'>-- | the default error message handler: error output to stderr</span>
<a name="line-501"></a>
<a name="line-502"></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-503"></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-504"></a>
<a name="line-505"></a><span class='comment'>-- | error message handler for collecting errors</span>
<a name="line-506"></a>
<a name="line-507"></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-508"></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-509"></a>
<a name="line-510"></a><span class='comment'>-- | error message handler for output to stderr and collecting</span>
<a name="line-511"></a>
<a name="line-512"></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-513"></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-514"></a>
<a name="line-515"></a><span class='comment'>-- | error message handler for ignoring errors</span>
<a name="line-516"></a>
<a name="line-517"></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-518"></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-519"></a>
<a name="line-520"></a><span class='comment'>-- |</span>
<a name="line-521"></a><span class='comment'>-- if error messages are collected by the error handler for</span>
<a name="line-522"></a><span class='comment'>-- processing these messages by the calling application,</span>
<a name="line-523"></a><span class='comment'>-- this arrow reads the stored messages and clears the error message store</span>
<a name="line-524"></a>
<a name="line-525"></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-526"></a><span class='definition'>getErrorMessages</span>
<a name="line-527"></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-528"></a> <span class='varop'>>>></span>
<a name="line-529"></a> <span class='varid'>clearErrorMsgList</span> <span class='comment'>-- clear the error list in the system state</span>
<a name="line-530"></a> <span class='varop'>>>></span>
<a name="line-531"></a> <span class='varid'>arrL</span> <span class='varid'>id</span>
<a name="line-532"></a>
<a name="line-533"></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-534"></a><span class='definition'>clearErrorMsgList</span>
<a name="line-535"></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-536"></a>
<a name="line-537"></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-538"></a><span class='definition'>addToErrorMsgList</span>
<a name="line-539"></a> <span class='keyglyph'>=</span> <span class='varid'>changeSysParam</span> <span class='varid'>cf</span>
<a name="line-540"></a> <span class='keyword'>where</span>
<a name="line-541"></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-542"></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-543"></a> <span class='keyword'>else</span> <span class='varid'>s</span>
<a name="line-544"></a>
<a name="line-545"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-546"></a>
<a name="line-547"></a><span class='comment'>-- |</span>
<a name="line-548"></a><span class='comment'>-- filter error messages from input trees and issue errors</span>
<a name="line-549"></a>
<a name="line-550"></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-551"></a><span class='definition'>filterErrorMsg</span>
<a name="line-552"></a> <span class='keyglyph'>=</span> <span class='layout'>(</span> <span class='varid'>setErrMsgStatus</span>
<a name="line-553"></a> <span class='varop'>>>></span>
<a name="line-554"></a> <span class='varid'>sysErrorMsg</span>
<a name="line-555"></a> <span class='varop'>>>></span>
<a name="line-556"></a> <span class='varid'>addToErrorMsgList</span>
<a name="line-557"></a> <span class='varop'>>>></span>
<a name="line-558"></a> <span class='varid'>none</span>
<a name="line-559"></a> <span class='layout'>)</span>
<a name="line-560"></a> <span class='varop'>`when`</span>
<a name="line-561"></a> <span class='varid'>isError</span>
<a name="line-562"></a>
<a name="line-563"></a><span class='comment'>-- | generate a warnig message</span>
<a name="line-564"></a>
<a name="line-565"></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-566"></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-567"></a>
<a name="line-568"></a><a name="issueErr"></a><span class='comment'>-- | generate an error message</span>
<a name="line-569"></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-570"></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-571"></a>
<a name="line-572"></a><span class='comment'>-- | generate a fatal error message, e.g. document not found</span>
<a name="line-573"></a>
<a name="line-574"></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-575"></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-576"></a>
<a name="line-577"></a><span class='comment'>-- |</span>
<a name="line-578"></a><span class='comment'>-- add the error level and the module where the error occured</span>
<a name="line-579"></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-580"></a><span class='comment'>-- called by 'setDocumentStatusFromSystemState' when the system state indicates an error</span>
<a name="line-581"></a>
<a name="line-582"></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-583"></a><span class='definition'>setDocumentStatus</span> <span class='varid'>level</span> <span class='varid'>msg</span>
<a name="line-584"></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-585"></a> <span class='varop'><+></span>
<a name="line-586"></a> <span class='varid'>sattr</span> <span class='varid'>a_module</span> <span class='varid'>msg</span>
<a name="line-587"></a> <span class='layout'>)</span>
<a name="line-588"></a> <span class='varop'>>>></span>
<a name="line-589"></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-590"></a> <span class='keyword'>then</span> <span class='varid'>setChildren</span> <span class='conid'>[]</span>
<a name="line-591"></a> <span class='keyword'>else</span> <span class='varid'>this</span>
<a name="line-592"></a> <span class='layout'>)</span>
<a name="line-593"></a> <span class='layout'>)</span>
<a name="line-594"></a> <span class='varop'>`when`</span>
<a name="line-595"></a> <span class='varid'>isRoot</span>
<a name="line-596"></a>
<a name="line-597"></a><span class='comment'>-- |</span>
<a name="line-598"></a><span class='comment'>-- check whether the error level attribute in the system state</span>
<a name="line-599"></a><span class='comment'>-- is set to error, in this case the children of the document root are</span>
<a name="line-600"></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-601"></a><span class='comment'>-- else nothing is changed</span>
<a name="line-602"></a>
<a name="line-603"></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-604"></a><span class='definition'>setDocumentStatusFromSystemState</span> <span class='varid'>msg</span>
<a name="line-605"></a> <span class='keyglyph'>=</span> <span class='varid'>setStatus</span> <span class='varop'>$<</span> <span class='varid'>getErrStatus</span>
<a name="line-606"></a> <span class='keyword'>where</span>
<a name="line-607"></a> <span class='varid'>setStatus</span> <span class='varid'>level</span>
<a name="line-608"></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-609"></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-610"></a>
<a name="line-611"></a>
<a name="line-612"></a><span class='comment'>-- |</span>
<a name="line-613"></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-614"></a>
<a name="line-615"></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-616"></a><span class='definition'>documentStatusOk</span>
<a name="line-617"></a> <span class='keyglyph'>=</span> <span class='varid'>isRoot</span>
<a name="line-618"></a> <span class='varop'>>>></span>
<a name="line-619"></a> <span class='layout'>(</span> <span class='layout'>(</span><span class='varid'>getAttrValue</span> <span class='varid'>a_status</span>
<a name="line-620"></a> <span class='varop'>>>></span>
<a name="line-621"></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-622"></a> <span class='layout'>)</span>
<a name="line-623"></a> <span class='varop'>`guards`</span>
<a name="line-624"></a> <span class='varid'>this</span>
<a name="line-625"></a> <span class='layout'>)</span>
<a name="line-626"></a>
<a name="line-627"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-628"></a>
<a name="line-629"></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-630"></a><span class='comment'>-- the input must be an absolute URI</span>
<a name="line-631"></a>
<a name="line-632"></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-633"></a><span class='definition'>setBaseURI</span>
<a name="line-634"></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-635"></a> <span class='varop'>>>></span>
<a name="line-636"></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-637"></a>
<a name="line-638"></a><span class='comment'>-- | read the base URI from the globale state</span>
<a name="line-639"></a>
<a name="line-640"></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-641"></a><span class='definition'>getBaseURI</span>
<a name="line-642"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_baseURI</span>
<a name="line-643"></a> <span class='varop'>>>></span>
<a name="line-644"></a> <span class='layout'>(</span> <span class='layout'>(</span> <span class='varid'>getDefaultBaseURI</span>
<a name="line-645"></a> <span class='varop'>>>></span>
<a name="line-646"></a> <span class='varid'>setBaseURI</span>
<a name="line-647"></a> <span class='varop'>>>></span>
<a name="line-648"></a> <span class='varid'>getBaseURI</span>
<a name="line-649"></a> <span class='layout'>)</span>
<a name="line-650"></a> <span class='varop'>`when`</span>
<a name="line-651"></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-652"></a> <span class='layout'>)</span>
<a name="line-653"></a>
<a name="line-654"></a><span class='comment'>-- | change the base URI with a possibly relative URI, can be used for</span>
<a name="line-655"></a><span class='comment'>-- evaluating the xml:base attribute. Returns the new absolute base URI.</span>
<a name="line-656"></a><span class='comment'>-- Fails, if input is not parsable with parseURIReference</span>
<a name="line-657"></a><span class='comment'>--</span>
<a name="line-658"></a><span class='comment'>-- see also: 'setBaseURI', 'mkAbsURI'</span>
<a name="line-659"></a>
<a name="line-660"></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-661"></a><span class='definition'>changeBaseURI</span>
<a name="line-662"></a> <span class='keyglyph'>=</span> <span class='varid'>mkAbsURI</span>
<a name="line-663"></a> <span class='varop'>>>></span>
<a name="line-664"></a> <span class='varid'>setBaseURI</span>
<a name="line-665"></a>
<a name="line-666"></a><span class='comment'>-- | set the default base URI, if parameter is null, the system base (@ file:\/\/\/\<cwd\>\/ @) is used,</span>
<a name="line-667"></a><span class='comment'>-- else the parameter, must be called before any document is read</span>
<a name="line-668"></a>
<a name="line-669"></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-670"></a><span class='definition'>setDefaultBaseURI</span> <span class='varid'>base</span>
<a name="line-671"></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-672"></a> <span class='keyword'>then</span> <span class='varid'>arrIO</span> <span class='varid'>getDir</span>
<a name="line-673"></a> <span class='keyword'>else</span> <span class='varid'>constA</span> <span class='varid'>base</span>
<a name="line-674"></a> <span class='layout'>)</span>
<a name="line-675"></a> <span class='varop'>>>></span>
<a name="line-676"></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-677"></a> <span class='varop'>>>></span>
<a name="line-678"></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-679"></a> <span class='keyword'>where</span>
<a name="line-680"></a> <span class='varid'>getDir</span> <span class='keyword'>_</span> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-681"></a> <span class='varid'>cwd</span> <span class='keyglyph'><-</span> <span class='varid'>getCurrentDirectory</span>
<a name="line-682"></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-683"></a>
<a name="line-684"></a> <span class='comment'>-- under Windows getCurrentDirectory returns something like: "c:\path\to\file"</span>
<a name="line-685"></a> <span class='comment'>-- backslaches are not allowed in URIs and paths must start with a /</span>
<a name="line-686"></a> <span class='comment'>-- so this is transformed into "/c:/path/to/file"</span>
<a name="line-687"></a>
<a name="line-688"></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-689"></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-690"></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-691"></a> <span class='varid'>normalize</span> <span class='varid'>wd'</span>
<a name="line-692"></a> <span class='keyglyph'>=</span> <span class='varid'>concatMap</span> <span class='varid'>escapeNonUriChar</span> <span class='varid'>wd'</span>
<a name="line-693"></a>
<a name="line-694"></a> <span class='varid'>win32ToUriChar</span> <span class='chr'>'\\'</span> <span class='keyglyph'>=</span> <span class='str'>"/"</span>
<a name="line-695"></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-696"></a>
<a name="line-697"></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-698"></a>
<a name="line-699"></a>
<a name="line-700"></a><span class='comment'>-- | get the default base URI</span>
<a name="line-701"></a>
<a name="line-702"></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-703"></a><span class='definition'>getDefaultBaseURI</span>
<a name="line-704"></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-705"></a> <span class='varop'>>>></span>
<a name="line-706"></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-707"></a> <span class='varop'>>>></span>
<a name="line-708"></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-709"></a>
<a name="line-710"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-711"></a>
<a name="line-712"></a><span class='comment'>-- | remember base uri, run an arrow and restore the base URI, used with external entity substitution</span>
<a name="line-713"></a>
<a name="line-714"></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-715"></a><span class='definition'>runInLocalURIContext</span> <span class='varid'>f</span>
<a name="line-716"></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-717"></a> <span class='varop'>>>></span>
<a name="line-718"></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-719"></a> <span class='varop'>>>></span>
<a name="line-720"></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-721"></a> <span class='varop'>>>></span>
<a name="line-722"></a> <span class='varid'>arrL</span> <span class='varid'>snd</span>
<a name="line-723"></a>
<a name="line-724"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-725"></a>
<a name="line-726"></a><span class='comment'>-- | set the global trace level</span>
<a name="line-727"></a>
<a name="line-728"></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-729"></a><span class='definition'>setTraceLevel</span> <span class='varid'>l</span>
<a name="line-730"></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-731"></a>
<a name="line-732"></a><span class='comment'>-- | read the global trace level</span>
<a name="line-733"></a>
<a name="line-734"></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-735"></a><span class='definition'>getTraceLevel</span>
<a name="line-736"></a> <span class='keyglyph'>=</span> <span class='varid'>getSysParam</span> <span class='varid'>xio_trace</span>
<a name="line-737"></a>
<a name="line-738"></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-739"></a>
<a name="line-740"></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-741"></a><span class='definition'>withTraceLevel</span> <span class='varid'>level</span> <span class='varid'>f</span>
<a name="line-742"></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-743"></a> <span class='varop'>>>></span>
<a name="line-744"></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-745"></a> <span class='varop'>>>></span>
<a name="line-746"></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-747"></a> <span class='varop'>>>></span>
<a name="line-748"></a> <span class='varid'>arrL</span> <span class='varid'>snd</span>
<a name="line-749"></a> <span class='keyword'>where</span>
<a name="line-750"></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-751"></a> <span class='varid'>restoreTraceLevel</span>
<a name="line-752"></a> <span class='keyglyph'>=</span> <span class='varid'>setTraceLevel</span> <span class='varop'>$<</span> <span class='varid'>this</span>
<a name="line-753"></a>
<a name="line-754"></a><span class='comment'>-- | apply a trace arrow and issue message to stderr</span>
<a name="line-755"></a>
<a name="line-756"></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-757"></a><span class='definition'>trace</span> <span class='varid'>level</span> <span class='varid'>trc</span>
<a name="line-758"></a> <span class='keyglyph'>=</span> <span class='varid'>perform</span> <span class='layout'>(</span> <span class='varid'>trc</span>
<a name="line-759"></a> <span class='varop'>>>></span>
<a name="line-760"></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-761"></a> <span class='varid'>hPutStrLn</span> <span class='varid'>stderr</span> <span class='varid'>s</span>
<a name="line-762"></a> <span class='varid'>hFlush</span> <span class='varid'>stderr</span>
<a name="line-763"></a> <span class='layout'>)</span>
<a name="line-764"></a> <span class='layout'>)</span>
<a name="line-765"></a> <span class='layout'>)</span>
<a name="line-766"></a> <span class='varop'>`when`</span> <span class='layout'>(</span> <span class='varid'>getTraceLevel</span>
<a name="line-767"></a> <span class='varop'>>>></span>
<a name="line-768"></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-769"></a> <span class='layout'>)</span>
<a name="line-770"></a>
<a name="line-771"></a><a name="traceMsg"></a><span class='comment'>-- | issue a string message as trace </span>
<a name="line-772"></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-773"></a><span class='definition'>traceMsg</span> <span class='varid'>level</span> <span class='varid'>msg</span>
<a name="line-774"></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-775"></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-776"></a> <span class='layout'>)</span>
<a name="line-777"></a>
<a name="line-778"></a><a name="traceString"></a><span class='comment'>-- | issue the string input of an arrow</span>
<a name="line-779"></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-780"></a><span class='definition'>traceString</span> <span class='varid'>level</span> <span class='varid'>f</span>
<a name="line-781"></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-782"></a>
<a name="line-783"></a><span class='comment'>-- | issue the source representation of a document if trace level >= 3</span>
<a name="line-784"></a><span class='comment'>--</span>
<a name="line-785"></a><span class='comment'>-- for better readability the source is formated with indentDoc</span>
<a name="line-786"></a>
<a name="line-787"></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-788"></a><span class='definition'>traceSource</span>
<a name="line-789"></a> <span class='keyglyph'>=</span> <span class='varid'>trace</span> <span class='num'>3</span> <span class='varop'>$</span>
<a name="line-790"></a> <span class='varid'>xshow</span>
<a name="line-791"></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-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> <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-796"></a> <span class='varop'>>>></span> <span class='varid'>indentDoc</span>
<a name="line-797"></a> <span class='varop'>>>></span> <span class='varid'>getChildren</span>
<a name="line-798"></a> <span class='varop'>>>></span> <span class='varid'>isElem</span>
<a name="line-799"></a> <span class='layout'>)</span>
<a name="line-800"></a> <span class='layout'>,</span> <span class='varid'>this</span> <span class='conop'>:-></span> <span class='varid'>this</span>
<a name="line-801"></a> <span class='keyglyph'>]</span>
<a name="line-802"></a> <span class='layout'>)</span>
<a name="line-803"></a>
<a name="line-804"></a><a name="traceTree"></a><span class='comment'>-- | issue the tree representation of a document if trace level >= 4</span>
<a name="line-805"></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-806"></a><span class='definition'>traceTree</span>
<a name="line-807"></a> <span class='keyglyph'>=</span> <span class='varid'>trace</span> <span class='num'>4</span> <span class='varop'>$</span>
<a name="line-808"></a> <span class='varid'>xshow</span> <span class='layout'>(</span> <span class='varid'>treeRepOfXmlDoc</span>
<a name="line-809"></a> <span class='varop'>>>></span>
<a name="line-810"></a> <span class='varid'>addHeadlineToXmlDoc</span>
<a name="line-811"></a> <span class='varop'>>>></span>
<a name="line-812"></a> <span class='varid'>getChildren</span>
<a name="line-813"></a> <span class='layout'>)</span>
<a name="line-814"></a>
<a name="line-815"></a><span class='comment'>-- | trace a main computation step</span>
<a name="line-816"></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-817"></a>
<a name="line-818"></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-819"></a><span class='definition'>traceDoc</span> <span class='varid'>msg</span>
<a name="line-820"></a> <span class='keyglyph'>=</span> <span class='varid'>traceMsg</span> <span class='num'>1</span> <span class='varid'>msg</span>
<a name="line-821"></a> <span class='varop'>>>></span>
<a name="line-822"></a> <span class='varid'>traceSource</span>
<a name="line-823"></a> <span class='varop'>>>></span>
<a name="line-824"></a> <span class='varid'>traceTree</span>
<a name="line-825"></a>
<a name="line-826"></a><span class='comment'>-- | trace the global state</span>
<a name="line-827"></a>
<a name="line-828"></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-829"></a><span class='definition'>traceState</span>
<a name="line-830"></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-831"></a> <span class='varop'>>>></span>
<a name="line-832"></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-833"></a> <span class='layout'>)</span>
<a name="line-834"></a> <span class='varop'>>>></span>
<a name="line-835"></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-836"></a> <span class='layout'>)</span>
<a name="line-837"></a> <span class='keyword'>where</span>
<a name="line-838"></a> <span class='comment'>-- formatParam :: (String, XmlTrees) -> IOStateArrow s b1 XmlTree</span>
<a name="line-839"></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-840"></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-841"></a>
<a name="line-842"></a><span class='comment'>-- ----------------------------------------------------------</span>
<a name="line-843"></a>
<a name="line-844"></a><span class='comment'>-- | compute the absolut URI for a given URI and a base URI</span>
<a name="line-845"></a>
<a name="line-846"></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-847"></a><span class='definition'>expandURIString</span> <span class='varid'>uri</span> <span class='varid'>base</span>
<a name="line-848"></a> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-849"></a> <span class='varid'>base'</span> <span class='keyglyph'><-</span> <span class='varid'>parseURIReference</span> <span class='varid'>base</span>
<a name="line-850"></a> <span class='varid'>uri'</span> <span class='keyglyph'><-</span> <span class='varid'>parseURIReference</span> <span class='varid'>uri</span>
<a name="line-851"></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-852"></a> <span class='varid'>return</span> <span class='varop'>$</span> <span class='varid'>show</span> <span class='varid'>abs'</span>
<a name="line-853"></a>
<a name="line-854"></a><span class='comment'>-- | arrow variant of 'expandURIString', fails if 'expandURIString' returns Nothing</span>
<a name="line-855"></a>
<a name="line-856"></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-857"></a><span class='definition'>expandURI</span>
<a name="line-858"></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-859"></a>
<a name="line-860"></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-861"></a>
<a name="line-862"></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-863"></a><span class='definition'>mkAbsURI</span>
<a name="line-864"></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-865"></a>
<a name="line-866"></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-867"></a><span class='comment'>--</span>
<a name="line-868"></a><span class='comment'>-- See Network.URI for URI components</span>
<a name="line-869"></a>
<a name="line-870"></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-871"></a><span class='definition'>getSchemeFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>scheme</span>
<a name="line-872"></a> <span class='keyword'>where</span>
<a name="line-873"></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-874"></a>
<a name="line-875"></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-876"></a>
<a name="line-877"></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-878"></a><span class='definition'>getRegNameFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>host</span>
<a name="line-879"></a> <span class='keyword'>where</span>
<a name="line-880"></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-881"></a>
<a name="line-882"></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-883"></a>
<a name="line-884"></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-885"></a><span class='definition'>getPortFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>port</span>
<a name="line-886"></a> <span class='keyword'>where</span>
<a name="line-887"></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-888"></a>
<a name="line-889"></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-890"></a>
<a name="line-891"></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-892"></a><span class='definition'>getUserInfoFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>ui</span>
<a name="line-893"></a> <span class='keyword'>where</span>
<a name="line-894"></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-895"></a>
<a name="line-896"></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-897"></a>
<a name="line-898"></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-899"></a><span class='definition'>getPathFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>uriPath</span>
<a name="line-900"></a>
<a name="line-901"></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-902"></a>
<a name="line-903"></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-904"></a><span class='definition'>getQueryFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>uriQuery</span>
<a name="line-905"></a>
<a name="line-906"></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-907"></a>
<a name="line-908"></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-909"></a><span class='definition'>getFragmentFromURI</span> <span class='keyglyph'>=</span> <span class='varid'>getPartFromURI</span> <span class='varid'>uriFragment</span>
<a name="line-910"></a>
<a name="line-911"></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-912"></a>
<a name="line-913"></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-914"></a><span class='definition'>getPartFromURI</span> <span class='varid'>sel</span>
<a name="line-915"></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-916"></a> <span class='keyword'>where</span>
<a name="line-917"></a> <span class='varid'>getPart</span> <span class='varid'>s</span> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-918"></a> <span class='varid'>uri</span> <span class='keyglyph'><-</span> <span class='varid'>parseURIReference</span> <span class='varid'>s</span>
<a name="line-919"></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-920"></a>
<a name="line-921"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-922"></a>
<a name="line-923"></a><span class='comment'>-- | set the table mapping of file extensions to mime types in the system state</span>
<a name="line-924"></a><span class='comment'>--</span>
<a name="line-925"></a><span class='comment'>-- Default table is defined in 'Text.XML.HXT.DOM.MimeTypeDefaults'.</span>
<a name="line-926"></a><span class='comment'>-- This table is used when reading loacl files, (file: protocol) to determine the mime type</span>
<a name="line-927"></a>
<a name="line-928"></a><a name="setMimeTypeTable"></a><span class='definition'>setMimeTypeTable</span> <span class='keyglyph'>::</span> <span class='conid'>MimeTypeTable</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-929"></a><span class='definition'>setMimeTypeTable</span> <span class='varid'>mtt</span>
<a name="line-930"></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_mimeTypes</span> <span class='keyglyph'>=</span> <span class='varid'>mtt</span><span class='layout'>}</span><span class='layout'>)</span>
<a name="line-931"></a>
<a name="line-932"></a><span class='comment'>-- | set the table mapping of file extensions to mime types by an external config file</span>
<a name="line-933"></a><span class='comment'>--</span>
<a name="line-934"></a><span class='comment'>-- The config file must follow the conventions of /etc/mime.types on a debian linux system,</span>
<a name="line-935"></a><span class='comment'>-- that means all empty lines and all lines starting with a # are ignored. The other lines</span>
<a name="line-936"></a><span class='comment'>-- must consist of a mime type followed by a possible empty list of extensions.</span>
<a name="line-937"></a><span class='comment'>-- The list of extenstions and mime types overwrites the default list in the system state</span>
<a name="line-938"></a><span class='comment'>-- of the IOStateArrow</span>
<a name="line-939"></a>
<a name="line-940"></a><a name="setMimeTypeTableFromFile"></a><span class='definition'>setMimeTypeTableFromFile</span> <span class='keyglyph'>::</span> <span class='conid'>FilePath</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-941"></a><span class='definition'>setMimeTypeTableFromFile</span> <span class='varid'>file</span>
<a name="line-942"></a> <span class='keyglyph'>=</span> <span class='varid'>setMimeTypeTable</span> <span class='varop'>$<</span> <span class='varid'>arrIO0</span> <span class='layout'>(</span> <span class='varid'>readMimeTypeTable</span> <span class='varid'>file</span><span class='layout'>)</span>
<a name="line-943"></a>
<a name="line-944"></a><span class='comment'>-- ------------------------------------------------------------</span>
</pre></body>
</html>