hxt-8.0.0: doc/hdoc/src/Text-XML-HXT-Parser-MainFunctions.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><span class='comment'>-- Simple parse functions.</span>
<a name="line-3"></a><span class='comment'>--</span>
<a name="line-4"></a><span class='comment'>-- Version : $Id: MainFunctions.hs,v 1.2 2004/11/20 16:53:15 hxml Exp $</span>
<a name="line-5"></a><span class='comment'>--</span>
<a name="line-6"></a><span class='comment'>--</span>
<a name="line-7"></a><span class='comment'>-- the main building blocks for an application.</span>
<a name="line-8"></a><span class='comment'>-- this module exports complex filters and functions for</span>
<a name="line-9"></a><span class='comment'>-- common tasks for input and parsing, output and option handling.</span>
<a name="line-10"></a><span class='comment'>--</span>
<a name="line-11"></a>
<a name="line-12"></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'>Parser</span><span class='varop'>.</span><span class='conid'>MainFunctions</span>
<a name="line-13"></a> <span class='layout'>(</span> <span class='varid'>getXmlDocument</span>
<a name="line-14"></a> <span class='layout'>,</span> <span class='varid'>putXmlDocument</span>
<a name="line-15"></a>
<a name="line-16"></a> <span class='layout'>,</span> <span class='varid'>parseDocument</span>
<a name="line-17"></a> <span class='layout'>,</span> <span class='varid'>writeDocument</span>
<a name="line-18"></a> <span class='layout'>)</span>
<a name="line-19"></a><span class='keyword'>where</span>
<a name="line-20"></a>
<a name="line-21"></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'>XmlTree</span>
<a name="line-22"></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'>XmlState</span>
<a name="line-23"></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'>Parser</span><span class='varop'>.</span><span class='conid'>HtmlParser</span>
<a name="line-24"></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'>Parser</span><span class='varop'>.</span><span class='conid'>XmlInput</span>
<a name="line-25"></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'>Parser</span><span class='varop'>.</span><span class='conid'>XmlOutput</span>
<a name="line-26"></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'>Parser</span><span class='varop'>.</span><span class='conid'>DTDProcessing</span>
<a name="line-27"></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'>Validator</span><span class='varop'>.</span><span class='conid'>Validation</span>
<a name="line-28"></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'>EditFilters</span>
<a name="line-29"></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'>Namespace</span>
<a name="line-30"></a>
<a name="line-31"></a><span class='keyword'>import</span> <span class='conid'>System</span><span class='varop'>.</span><span class='conid'>IO</span>
<a name="line-32"></a>
<a name="line-33"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-34"></a>
<a name="line-35"></a><span class='comment'>-- |</span>
<a name="line-36"></a><span class='comment'>-- convenient function for reading a XML document without</span>
<a name="line-37"></a><span class='comment'>-- dealing with state monads, error messages collection and other details</span>
<a name="line-38"></a><span class='comment'>--</span>
<a name="line-39"></a><span class='comment'>-- getXmlDocument calls 'parseDocument' with the list of parsing options</span>
<a name="line-40"></a><span class='comment'>-- and an url or filename as document source.</span>
<a name="line-41"></a><span class='comment'>--</span>
<a name="line-42"></a><span class='comment'>-- result is a triple</span>
<a name="line-43"></a><span class='comment'>--</span>
<a name="line-44"></a><span class='comment'>-- * the resulting document tree with a root node containing all</span>
<a name="line-45"></a><span class='comment'>-- meta info about the document (options, status info, http header, ...)</span>
<a name="line-46"></a><span class='comment'>--</span>
<a name="line-47"></a><span class='comment'>-- - the list of errors and warnings</span>
<a name="line-48"></a><span class='comment'>--</span>
<a name="line-49"></a><span class='comment'>-- - the error level: one of 'c_ok', 'c_warn', 'c_err', 'c_fatal'</span>
<a name="line-50"></a><span class='comment'>--</span>
<a name="line-51"></a><span class='comment'>-- example for input (see also example in 'putXmlDocument' and example in 'writeDocument')</span>
<a name="line-52"></a><span class='comment'>--</span>
<a name="line-53"></a><span class='comment'>-- > main :: IO ()</span>
<a name="line-54"></a><span class='comment'>-- > main</span>
<a name="line-55"></a><span class='comment'>-- > = do</span>
<a name="line-56"></a><span class='comment'>-- > (res, errs, rc) <- getXmlDocument [] "test.xml"</span>
<a name="line-57"></a><span class='comment'>-- > if rc >= c_err</span>
<a name="line-58"></a><span class='comment'>-- > then issueErrors errs</span>
<a name="line-59"></a><span class='comment'>-- > else processTree res</span>
<a name="line-60"></a><span class='comment'>-- ></span>
<a name="line-61"></a><span class='comment'>-- > issueErrors :: XmlTrees -> IO ()</span>
<a name="line-62"></a><span class='comment'>-- ></span>
<a name="line-63"></a><span class='comment'>-- > processTree :: XmlTree -> IO ()</span>
<a name="line-64"></a><span class='comment'>--</span>
<a name="line-65"></a><span class='comment'>-- for options see 'parseDocument', 'a_collect_errors' is set implicitly</span>
<a name="line-66"></a>
<a name="line-67"></a><a name="getXmlDocument"></a><span class='definition'>getXmlDocument</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>IO</span> <span class='layout'>(</span><span class='conid'>XmlTree</span><span class='layout'>,</span> <span class='conid'>XmlTrees</span><span class='layout'>,</span> <span class='conid'>Int</span><span class='layout'>)</span>
<a name="line-68"></a><span class='definition'>getXmlDocument</span> <span class='varid'>options</span> <span class='varid'>url</span>
<a name="line-69"></a> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-70"></a> <span class='keyword'>let</span> <span class='varid'>options'</span> <span class='keyglyph'>=</span> <span class='keyglyph'>[</span> <span class='layout'>(</span><span class='varid'>a_collect_errors</span><span class='layout'>,</span> <span class='varid'>v_1</span><span class='layout'>)</span> <span class='comment'>-- collect errors</span>
<a name="line-71"></a> <span class='layout'>,</span> <span class='layout'>(</span><span class='varid'>a_issue_errors</span><span class='layout'>,</span> <span class='varid'>v_0</span><span class='layout'>)</span> <span class='comment'>-- but don't issue</span>
<a name="line-72"></a> <span class='keyglyph'>]</span> <span class='comment'>-- can be overwritten by supporting other values in options</span>
<a name="line-73"></a> <span class='varop'>++</span>
<a name="line-74"></a> <span class='varid'>options</span>
<a name="line-75"></a> <span class='varop'>++</span>
<a name="line-76"></a> <span class='keyglyph'>[</span> <span class='layout'>(</span><span class='varid'>a_source</span><span class='layout'>,</span> <span class='varid'>url</span><span class='layout'>)</span> <span class='comment'>-- set the source url</span>
<a name="line-77"></a> <span class='keyglyph'>]</span>
<a name="line-78"></a> <span class='varid'>res</span> <span class='keyglyph'><-</span> <span class='varid'>run'</span> <span class='varop'>$</span> <span class='varid'>parseDocument</span> <span class='varid'>options'</span> <span class='varid'>emptyRoot</span>
<a name="line-79"></a> <span class='keyword'>let</span> <span class='varid'>root</span> <span class='keyglyph'>=</span> <span class='varid'>head</span> <span class='varid'>res</span>
<a name="line-80"></a> <span class='keyword'>let</span> <span class='varid'>errs</span> <span class='keyglyph'>=</span> <span class='varid'>tail</span> <span class='varid'>res</span>
<a name="line-81"></a> <span class='keyword'>let</span> <span class='varid'>elvl</span> <span class='keyglyph'>=</span> <span class='varid'>intValueOf</span> <span class='varid'>a_status</span> <span class='varid'>root</span>
<a name="line-82"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>root</span><span class='layout'>,</span> <span class='varid'>errs</span><span class='layout'>,</span> <span class='varid'>elvl</span><span class='layout'>)</span>
<a name="line-83"></a>
<a name="line-84"></a>
<a name="line-85"></a><span class='comment'>-- |</span>
<a name="line-86"></a><span class='comment'>-- the inverse operation to 'getXmlDocument'</span>
<a name="line-87"></a><span class='comment'>--</span>
<a name="line-88"></a><span class='comment'>-- writes a complete document tree to a file, writing can be</span>
<a name="line-89"></a><span class='comment'>-- controlled by options, the real work is done with filter 'writeDocument'.</span>
<a name="line-90"></a><span class='comment'>-- useful options are the options of 'writeDocument'.</span>
<a name="line-91"></a><span class='comment'>--</span>
<a name="line-92"></a><span class='comment'>-- result is a pair: 1.part is a list of error messages, 2. part is the return code,</span>
<a name="line-93"></a><span class='comment'>-- the status info of the write filter</span>
<a name="line-94"></a><span class='comment'>--</span>
<a name="line-95"></a><span class='comment'>-- this filter is useful, when processing XML in an arbitray context in the IO monad</span>
<a name="line-96"></a><span class='comment'>--</span>
<a name="line-97"></a><span class='comment'>-- an example main program for such an application is:</span>
<a name="line-98"></a><span class='comment'>--</span>
<a name="line-99"></a><span class='comment'>-- > main :: IO ()</span>
<a name="line-100"></a><span class='comment'>-- > main</span>
<a name="line-101"></a><span class='comment'>-- > = do</span>
<a name="line-102"></a><span class='comment'>-- > (input, readErrs, rc) <- getXmlDocument [...] "test.xml"</span>
<a name="line-103"></a><span class='comment'>-- > if rc >= c_err</span>
<a name="line-104"></a><span class='comment'>-- > then issueErrors readErrs</span>
<a name="line-105"></a><span class='comment'>-- > else processTree input</span>
<a name="line-106"></a><span class='comment'>-- ></span>
<a name="line-107"></a><span class='comment'>-- > processTree :: XmlTree -> IO ()</span>
<a name="line-108"></a><span class='comment'>-- > processTree t</span>
<a name="line-109"></a><span class='comment'>-- > = let res = computeNewTree input</span>
<a name="line-110"></a><span class='comment'>-- > in do</span>
<a name="line-111"></a><span class='comment'>-- > (writeErrs, rc2) <- putXmlDocument [...] "out.xml" res</span>
<a name="line-112"></a><span class='comment'>-- > if rc2 >= c_err</span>
<a name="line-113"></a><span class='comment'>-- > then issueErrors writeErrs</span>
<a name="line-114"></a><span class='comment'>-- > else return ()</span>
<a name="line-115"></a><span class='comment'>-- ></span>
<a name="line-116"></a><span class='comment'>-- > issueErrors :: XmlTrees -> IO ()</span>
<a name="line-117"></a><span class='comment'>-- ></span>
<a name="line-118"></a><span class='comment'>-- > computeNewTree :: XmlTree -> XmlTree</span>
<a name="line-119"></a>
<a name="line-120"></a>
<a name="line-121"></a><a name="putXmlDocument"></a><span class='definition'>putXmlDocument</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>String</span> <span class='keyglyph'>-></span> <span class='conid'>XmlTree</span> <span class='keyglyph'>-></span> <span class='conid'>IO</span> <span class='layout'>(</span><span class='conid'>XmlTrees</span><span class='layout'>,</span> <span class='conid'>Int</span><span class='layout'>)</span>
<a name="line-122"></a><span class='definition'>putXmlDocument</span> <span class='varid'>options</span> <span class='varid'>fileName</span> <span class='varid'>t</span>
<a name="line-123"></a> <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-124"></a> <span class='keyword'>let</span> <span class='varid'>options'</span> <span class='keyglyph'>=</span> <span class='keyglyph'>[</span> <span class='layout'>(</span><span class='varid'>a_collect_errors</span><span class='layout'>,</span> <span class='varid'>v_1</span><span class='layout'>)</span> <span class='comment'>-- collect errors</span>
<a name="line-125"></a> <span class='layout'>,</span> <span class='layout'>(</span><span class='varid'>a_issue_errors</span><span class='layout'>,</span> <span class='varid'>v_0</span><span class='layout'>)</span> <span class='comment'>-- but don't issue</span>
<a name="line-126"></a> <span class='keyglyph'>]</span> <span class='comment'>-- can be overwritten by supporting other values in options</span>
<a name="line-127"></a> <span class='varop'>++</span>
<a name="line-128"></a> <span class='varid'>options</span>
<a name="line-129"></a> <span class='varop'>++</span>
<a name="line-130"></a> <span class='keyglyph'>[</span> <span class='layout'>(</span><span class='varid'>a_output_file</span><span class='layout'>,</span> <span class='varid'>fileName</span><span class='layout'>)</span> <span class='comment'>-- set the source url</span>
<a name="line-131"></a> <span class='keyglyph'>]</span>
<a name="line-132"></a> <span class='varid'>res</span> <span class='keyglyph'><-</span> <span class='varid'>run'</span> <span class='varop'>$</span> <span class='varid'>writeDocument</span> <span class='varid'>options'</span> <span class='varid'>t</span>
<a name="line-133"></a> <span class='keyword'>let</span> <span class='varid'>root</span> <span class='keyglyph'>=</span> <span class='varid'>head</span> <span class='varid'>res</span>
<a name="line-134"></a> <span class='keyword'>let</span> <span class='varid'>errs</span> <span class='keyglyph'>=</span> <span class='varid'>tail</span> <span class='varid'>res</span>
<a name="line-135"></a> <span class='keyword'>let</span> <span class='varid'>elvl</span> <span class='keyglyph'>=</span> <span class='varid'>intValueOf</span> <span class='varid'>a_status</span> <span class='varid'>root</span>
<a name="line-136"></a> <span class='varid'>return</span> <span class='layout'>(</span><span class='varid'>errs</span><span class='layout'>,</span> <span class='varid'>elvl</span><span class='layout'>)</span>
<a name="line-137"></a>
<a name="line-138"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-139"></a>
<a name="line-140"></a><span class='comment'>-- |</span>
<a name="line-141"></a><span class='comment'>-- the main parsing filter</span>
<a name="line-142"></a><span class='comment'>--</span>
<a name="line-143"></a><span class='comment'>-- this filter can be configured by an option list, a list of</span>
<a name="line-144"></a><span class='comment'>-- option name, option value pairs.</span>
<a name="line-145"></a><span class='comment'>-- the input tree must be a possibly empty document root tree.</span>
<a name="line-146"></a><span class='comment'>-- all the options are stored as attributes in this root node to control processing.</span>
<a name="line-147"></a><span class='comment'>--</span>
<a name="line-148"></a><span class='comment'>-- available options:</span>
<a name="line-149"></a><span class='comment'>--</span>
<a name="line-150"></a><span class='comment'>-- * 'a_parse_html': use HTML parser, else use XML parser (default)</span>
<a name="line-151"></a><span class='comment'>--</span>
<a name="line-152"></a><span class='comment'>-- - 'a_validate' : validate document (default), else skip validation</span>
<a name="line-153"></a><span class='comment'>--</span>
<a name="line-154"></a><span class='comment'>-- - 'a_check_namespaces' : check namespaces, else skip namespace processing (default)</span>
<a name="line-155"></a><span class='comment'>--</span>
<a name="line-156"></a><span class='comment'>-- - 'a_canonicalize' : canonicalize document (default), else skip canonicalization</span>
<a name="line-157"></a><span class='comment'>--</span>
<a name="line-158"></a><span class='comment'>-- - 'a_preserve_comment' : preserve comments during canonicalization, else remove comments (default)</span>
<a name="line-159"></a><span class='comment'>--</span>
<a name="line-160"></a><span class='comment'>-- - 'a_remove_whitespace' : remove all whitespace, used for document indentation, else skip this step (default)</span>
<a name="line-161"></a><span class='comment'>--</span>
<a name="line-162"></a><span class='comment'>-- - 'a_indent' : indent document by inserting whitespace, else skip this step (default)</span>
<a name="line-163"></a><span class='comment'>--</span>
<a name="line-164"></a><span class='comment'>-- - 'a_issue_warnings' : issue warnings, when parsing HTML (default), else ignore HTML parser warnings</span>
<a name="line-165"></a><span class='comment'>--</span>
<a name="line-166"></a><span class='comment'>-- - 'a_issue_errors' : issue all error messages on stderr (default), or ignore all error messages</span>
<a name="line-167"></a><span class='comment'>--</span>
<a name="line-168"></a><span class='comment'>-- - 'a_collect_errors' : all error messages are collected during processing and appended to the result document</span>
<a name="line-169"></a><span class='comment'>-- for further processing within the calling modules</span>
<a name="line-170"></a><span class='comment'>--</span>
<a name="line-171"></a><span class='comment'>-- - 'a_trace' : trace level: values: 0 -4</span>
<a name="line-172"></a><span class='comment'>--</span>
<a name="line-173"></a><span class='comment'>-- - 'a_proxy' : proxy for http access, e.g. www-cache:3128</span>
<a name="line-174"></a><span class='comment'>--</span>
<a name="line-175"></a><span class='comment'>-- - 'a_use_curl' : for http access via external programm curl, default is native HTTP access</span>
<a name="line-176"></a><span class='comment'>--</span>
<a name="line-177"></a><span class='comment'>-- - 'a_options_curl' : more options for external program curl</span>
<a name="line-178"></a><span class='comment'>--</span>
<a name="line-179"></a><span class='comment'>-- - 'a_source' : the document source url</span>
<a name="line-180"></a><span class='comment'>--</span>
<a name="line-181"></a><span class='comment'>-- - 'a_encoding' : default document encoding ('utf8', 'isoLatin1', 'usAscii', ...)</span>
<a name="line-182"></a><span class='comment'>--</span>
<a name="line-183"></a><span class='comment'>-- examples:</span>
<a name="line-184"></a><span class='comment'>--</span>
<a name="line-185"></a><span class='comment'>-- > parseDocument [ (a_source, "test.xml")</span>
<a name="line-186"></a><span class='comment'>-- > , (a_validate, "0")</span>
<a name="line-187"></a><span class='comment'>-- > , (a_encoding, isoLatin1)</span>
<a name="line-188"></a><span class='comment'>-- > ] emptyRoot</span>
<a name="line-189"></a><span class='comment'>--</span>
<a name="line-190"></a><span class='comment'>-- reads document \"test.xml\" without validation and default encoding 'isoLatin1'</span>
<a name="line-191"></a><span class='comment'>--</span>
<a name="line-192"></a><span class='comment'>-- > parseDocument [ (a_source, "<a href="http://www.haskell.org/">http://www.haskell.org/</a>")</span>
<a name="line-193"></a><span class='comment'>-- > , (a_parse_html, "1")</span>
<a name="line-194"></a><span class='comment'>-- > , (a_proxy, "www-cache:3128")</span>
<a name="line-195"></a><span class='comment'>-- > , (a_curl, "1")</span>
<a name="line-196"></a><span class='comment'>-- > , (a_issue_warnings, "0")</span>
<a name="line-197"></a><span class='comment'>-- > ] emptyRoot</span>
<a name="line-198"></a><span class='comment'>--</span>
<a name="line-199"></a><span class='comment'>-- reads Haskell homepage with HTML parser ignoring any warnings and with http access via external program curl and proxy \"www-cache\" at port 3128</span>
<a name="line-200"></a><span class='comment'>--</span>
<a name="line-201"></a><span class='comment'>-- > parseDocument [ (a_source, "<a href="http://www.w3c.org/">http://www.w3c.org/</a>")</span>
<a name="line-202"></a><span class='comment'>-- > , (a_parse_html, "0") -- default</span>
<a name="line-203"></a><span class='comment'>-- > , (a_validate, "1") -- default</span>
<a name="line-204"></a><span class='comment'>-- > , (a_check_namespace, "1")</span>
<a name="line-205"></a><span class='comment'>-- > , (a_remove_whitespace, "1")</span>
<a name="line-206"></a><span class='comment'>-- > , (a_trace, "2")</span>
<a name="line-207"></a><span class='comment'>-- > ] emptyRoot</span>
<a name="line-208"></a><span class='comment'>--</span>
<a name="line-209"></a><span class='comment'>-- read w3c home page, validate and chech namespaces, remove whitespace between tags, trace activities with level 2</span>
<a name="line-210"></a><span class='comment'>--</span>
<a name="line-211"></a><span class='comment'>-- > parseDocument [ (a_source, "test.xml")</span>
<a name="line-212"></a><span class='comment'>-- > , (a_validate, "1")</span>
<a name="line-213"></a><span class='comment'>-- > , (a_check_namespace, "1")</span>
<a name="line-214"></a><span class='comment'>-- > , (a_collect_errors, "1")</span>
<a name="line-215"></a><span class='comment'>-- > , (a_issue_errors, "0")</span>
<a name="line-216"></a><span class='comment'>-- > ] emptyRoot</span>
<a name="line-217"></a><span class='comment'>--</span>
<a name="line-218"></a><span class='comment'>-- reads file \"test.xml\", validates it, checks namespaces, does not issue any erros</span>
<a name="line-219"></a><span class='comment'>-- but collects errors and appends the list of errors to the single element list for the document.</span>
<a name="line-220"></a><span class='comment'>-- this enables the calling application to define own error handlers.</span>
<a name="line-221"></a>
<a name="line-222"></a><a name="parseDocument"></a><span class='definition'>parseDocument</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>XmlStateFilter</span> <span class='varid'>state</span>
<a name="line-223"></a><span class='definition'>parseDocument</span> <span class='varid'>userOptions</span>
<a name="line-224"></a> <span class='keyglyph'>=</span> <span class='varid'>processDocument</span> <span class='varid'>userOptions</span> <span class='varid'>defaultOptions</span>
<a name="line-225"></a> <span class='layout'>(</span> <span class='varid'>traceMsg</span> <span class='num'>1</span> <span class='str'>"parseDocument: options added, start processing"</span>
<a name="line-226"></a> <span class='varop'>.>></span>
<a name="line-227"></a> <span class='varid'>traceTree</span>
<a name="line-228"></a> <span class='varop'>.>></span>
<a name="line-229"></a> <span class='varid'>getXmlContents</span> <span class='comment'>-- get the content as text</span>
<a name="line-230"></a> <span class='varop'>.>></span>
<a name="line-231"></a> <span class='varid'>choiceM</span> <span class='comment'>-- select parser</span>
<a name="line-232"></a> <span class='keyglyph'>[</span> <span class='varid'>hasOption</span> <span class='varid'>a_parse_html</span>
<a name="line-233"></a> <span class='conop'>:-></span> <span class='varid'>parseHtmlDoc</span> <span class='comment'>-- parse everything as HTML</span>
<a name="line-234"></a> <span class='layout'>,</span> <span class='varid'>this</span>
<a name="line-235"></a> <span class='conop'>:-></span> <span class='varid'>checkWellformedDoc</span> <span class='comment'>-- parse XML and process entities</span>
<a name="line-236"></a> <span class='varop'>.>></span>
<a name="line-237"></a> <span class='layout'>(</span> <span class='varid'>getValidatedDoc</span> <span class='comment'>-- validate</span>
<a name="line-238"></a> <span class='varop'>`whenM`</span>
<a name="line-239"></a> <span class='varid'>hasOption</span> <span class='varid'>a_validate</span>
<a name="line-240"></a> <span class='layout'>)</span>
<a name="line-241"></a> <span class='keyglyph'>]</span>
<a name="line-242"></a> <span class='varop'>.>></span>
<a name="line-243"></a> <span class='layout'>(</span> <span class='varid'>propagateAndValidateNamespaces</span> <span class='comment'>-- namespace processing</span>
<a name="line-244"></a> <span class='varop'>`whenM`</span>
<a name="line-245"></a> <span class='varid'>hasOption</span> <span class='varid'>a_check_namespaces</span>
<a name="line-246"></a> <span class='layout'>)</span>
<a name="line-247"></a> <span class='varop'>.>></span>
<a name="line-248"></a> <span class='varid'>liftMf</span> <span class='comment'>-- canonicalization</span>
<a name="line-249"></a> <span class='layout'>(</span> <span class='varid'>choice</span>
<a name="line-250"></a> <span class='keyglyph'>[</span> <span class='varid'>hasOption</span> <span class='varid'>a_preserve_comment</span> <span class='comment'>-- don't remove comments (in XPath required)</span>
<a name="line-251"></a> <span class='conop'>:-></span> <span class='varid'>canonicalizeForXPath</span>
<a name="line-252"></a> <span class='layout'>,</span> <span class='varid'>this</span>
<a name="line-253"></a> <span class='conop'>:-></span> <span class='varid'>canonicalizeAllNodes</span> <span class='comment'>-- do normal canonicaliazion</span>
<a name="line-254"></a> <span class='keyglyph'>]</span>
<a name="line-255"></a> <span class='varop'>`when`</span>
<a name="line-256"></a> <span class='varid'>hasOption</span> <span class='varid'>a_canonicalize</span> <span class='comment'>-- caconicalization can be switched off</span>
<a name="line-257"></a> <span class='layout'>)</span>
<a name="line-258"></a> <span class='varop'>.>></span>
<a name="line-259"></a> <span class='varid'>liftMf</span>
<a name="line-260"></a> <span class='layout'>(</span> <span class='varid'>removeDocWhiteSpace</span> <span class='comment'>-- remove all whitespace between tags</span>
<a name="line-261"></a> <span class='varop'>`when`</span>
<a name="line-262"></a> <span class='varid'>hasOption</span> <span class='varid'>a_remove_whitespace</span>
<a name="line-263"></a> <span class='layout'>)</span>
<a name="line-264"></a> <span class='varop'>.>></span>
<a name="line-265"></a> <span class='varid'>traceMsg</span> <span class='num'>1</span> <span class='str'>"parseDocument: document processed"</span> <span class='comment'>-- trace output</span>
<a name="line-266"></a> <span class='varop'>.>></span>
<a name="line-267"></a> <span class='varid'>traceSource</span>
<a name="line-268"></a> <span class='varop'>.>></span>
<a name="line-269"></a> <span class='varid'>traceTree</span>
<a name="line-270"></a> <span class='layout'>)</span>
<a name="line-271"></a> <span class='keyword'>where</span>
<a name="line-272"></a> <span class='varid'>defaultOptions</span>
<a name="line-273"></a> <span class='keyglyph'>=</span> <span class='keyglyph'>[</span> <span class='layout'>(</span> <span class='varid'>a_parse_html</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-274"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_validate</span><span class='layout'>,</span> <span class='varid'>v_1</span> <span class='layout'>)</span>
<a name="line-275"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_issue_errors</span><span class='layout'>,</span> <span class='varid'>v_1</span> <span class='layout'>)</span>
<a name="line-276"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_issue_warnings</span><span class='layout'>,</span> <span class='varid'>v_1</span> <span class='layout'>)</span>
<a name="line-277"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_check_namespaces</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-278"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_canonicalize</span><span class='layout'>,</span> <span class='varid'>v_1</span> <span class='layout'>)</span>
<a name="line-279"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_preserve_comment</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-280"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_remove_whitespace</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-281"></a> <span class='keyglyph'>]</span>
<a name="line-282"></a>
<a name="line-283"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-284"></a>
<a name="line-285"></a><a name="addOptions"></a><span class='definition'>addOptions</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>XmlFilter</span>
<a name="line-286"></a><span class='definition'>addOptions</span>
<a name="line-287"></a> <span class='keyglyph'>=</span> <span class='varid'>seqF</span> <span class='varop'>.</span> <span class='varid'>map</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='layout'>(</span><span class='varid'>n</span><span class='layout'>,</span><span class='varid'>v</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='varid'>addAttr</span> <span class='varid'>n</span> <span class='varid'>v</span> <span class='layout'>)</span>
<a name="line-288"></a>
<a name="line-289"></a><a name="addDefaultOptions"></a><span class='definition'>addDefaultOptions</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>XmlFilter</span>
<a name="line-290"></a><span class='definition'>addDefaultOptions</span>
<a name="line-291"></a> <span class='keyglyph'>=</span> <span class='varid'>seqF</span> <span class='varop'>.</span> <span class='varid'>map</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='layout'>(</span><span class='varid'>n</span><span class='layout'>,</span><span class='varid'>v</span><span class='layout'>)</span> <span class='keyglyph'>-></span> <span class='varid'>addAttr</span> <span class='varid'>n</span> <span class='varid'>v</span> <span class='varop'>`whenNot`</span> <span class='varid'>hasAttr</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-292"></a>
<a name="line-293"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-294"></a>
<a name="line-295"></a><span class='comment'>-- |</span>
<a name="line-296"></a><span class='comment'>-- the main filter for writing documents</span>
<a name="line-297"></a><span class='comment'>--</span>
<a name="line-298"></a><span class='comment'>-- this filter can be configured by an option list like 'getXmlDocument'</span>
<a name="line-299"></a><span class='comment'>--</span>
<a name="line-300"></a><span class='comment'>-- available options are</span>
<a name="line-301"></a><span class='comment'>--</span>
<a name="line-302"></a><span class='comment'>-- * 'a_indent' : indent document for readability, (default: no indentation)</span>
<a name="line-303"></a><span class='comment'>--</span>
<a name="line-304"></a><span class='comment'>-- - 'a_remove_whitespace' : remove all redundant whitespace for shorten text (default: no removal)</span>
<a name="line-305"></a><span class='comment'>--</span>
<a name="line-306"></a><span class='comment'>-- - 'a_output_file' : destination file for document, default is \"-\" for stdout</span>
<a name="line-307"></a><span class='comment'>--</span>
<a name="line-308"></a><span class='comment'>-- - 'a_output_encoding' : encoding of document, default is 'a_encoding' or 'utf8'</span>
<a name="line-309"></a><span class='comment'>--</span>
<a name="line-310"></a><span class='comment'>-- - 'a_output_xml' : (default) issue XML: quote special XML chars \>,\<,\",\',&</span>
<a name="line-311"></a><span class='comment'>-- add XML processing instruction</span>
<a name="line-312"></a><span class='comment'>-- and encode document with respect to 'a_output_encoding',</span>
<a name="line-313"></a><span class='comment'>-- if explizitly switched of, the plain text is issued, this is useful</span>
<a name="line-314"></a><span class='comment'>-- for non XML output, e.g. generated Haskell code, LaTex, Java, ...</span>
<a name="line-315"></a><span class='comment'>--</span>
<a name="line-316"></a><span class='comment'>-- - 'a_show_tree' : show tree representation of document (for debugging)</span>
<a name="line-317"></a><span class='comment'>--</span>
<a name="line-318"></a><span class='comment'>-- - 'a_show_haskell' : show Haskell representaion of document (for debugging)</span>
<a name="line-319"></a><span class='comment'>--</span>
<a name="line-320"></a><span class='comment'>-- - 'a_issue_errors', 'a_collect_errors' : see 'parseDocument'</span>
<a name="line-321"></a><span class='comment'>--</span>
<a name="line-322"></a><span class='comment'>-- a typical main program running in the XmlState monad</span>
<a name="line-323"></a><span class='comment'>-- has the following structure:</span>
<a name="line-324"></a><span class='comment'>--</span>
<a name="line-325"></a><span class='comment'>-- ></span>
<a name="line-326"></a><span class='comment'>-- > main :: IO ()</span>
<a name="line-327"></a><span class='comment'>-- > main</span>
<a name="line-328"></a><span class='comment'>-- > = do</span>
<a name="line-329"></a><span class='comment'>-- > argv <- getArgs -- get the commandline arguments</span>
<a name="line-330"></a><span class='comment'>-- > (inp, outp, options) <- cmdlineOpts argv -- and evaluate them, return a key-value list</span>
<a name="line-331"></a><span class='comment'>-- > -- and input and output</span>
<a name="line-332"></a><span class='comment'>-- > res <- run' $ application inp outp options $ emptyRoot -- run the application</span>
<a name="line-333"></a><span class='comment'>-- > </span>
<a name="line-334"></a><span class='comment'>-- > exitWith (if null res</span>
<a name="line-335"></a><span class='comment'>-- > then ExitFailure (-1)</span>
<a name="line-336"></a><span class='comment'>-- > else exitSuccess</span>
<a name="line-337"></a><span class='comment'>-- > )</span>
<a name="line-338"></a><span class='comment'>-- ></span>
<a name="line-339"></a><span class='comment'>-- > application :: String -> String -> Attributes -> XmlStateFilter ()</span>
<a name="line-340"></a><span class='comment'>-- > application inp outp al</span>
<a name="line-341"></a><span class='comment'>-- > = parseDocument (al ++ [(a_source, inp)]) -- set options and source</span>
<a name="line-342"></a><span class='comment'>-- > .>> -- and parse document</span>
<a name="line-343"></a><span class='comment'>-- > processDocument -- the hard work</span>
<a name="line-344"></a><span class='comment'>-- > .>></span>
<a name="line-345"></a><span class='comment'>-- > writeDocument [(a_output_file, outp)] -- issue results</span>
<a name="line-346"></a><span class='comment'>-- > .>></span>
<a name="line-347"></a><span class='comment'>-- > checkStatus -- check errors</span>
<a name="line-348"></a><span class='comment'>-- ></span>
<a name="line-349"></a>
<a name="line-350"></a>
<a name="line-351"></a><a name="writeDocument"></a><span class='definition'>writeDocument</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>XmlStateFilter</span> <span class='varid'>state</span>
<a name="line-352"></a><span class='definition'>writeDocument</span> <span class='varid'>userOptions</span>
<a name="line-353"></a> <span class='keyglyph'>=</span> <span class='varid'>processDocument</span> <span class='varid'>userOptions</span> <span class='varid'>defaultOptions</span>
<a name="line-354"></a> <span class='layout'>(</span> <span class='varid'>traceMsg</span> <span class='num'>1</span> <span class='str'>"writeDocument: options added, start processing"</span>
<a name="line-355"></a> <span class='varop'>.>></span>
<a name="line-356"></a> <span class='varid'>liftMf</span>
<a name="line-357"></a> <span class='layout'>(</span> <span class='varid'>choice</span>
<a name="line-358"></a> <span class='keyglyph'>[</span> <span class='varid'>hasOption</span> <span class='varid'>a_indent</span> <span class='conop'>:-></span> <span class='varid'>indentDoc</span> <span class='comment'>-- document indentation</span>
<a name="line-359"></a> <span class='layout'>,</span> <span class='varid'>hasOption</span> <span class='varid'>a_remove_whitespace</span> <span class='conop'>:-></span> <span class='varid'>removeDocWhiteSpace</span> <span class='comment'>-- remove all whitespace between tags</span>
<a name="line-360"></a> <span class='layout'>,</span> <span class='varid'>this</span> <span class='conop'>:-></span> <span class='varid'>this</span>
<a name="line-361"></a> <span class='keyglyph'>]</span>
<a name="line-362"></a> <span class='layout'>)</span>
<a name="line-363"></a> <span class='varop'>.>></span>
<a name="line-364"></a> <span class='varid'>liftMf</span>
<a name="line-365"></a> <span class='layout'>(</span> <span class='varid'>choice</span>
<a name="line-366"></a> <span class='keyglyph'>[</span> <span class='varid'>hasOption</span> <span class='varid'>a_show_tree</span> <span class='conop'>:-></span> <span class='varid'>treeRepOfXmlDoc</span>
<a name="line-367"></a> <span class='layout'>,</span> <span class='varid'>hasOption</span> <span class='varid'>a_show_haskell</span> <span class='conop'>:-></span> <span class='varid'>haskellRepOfXmlDoc</span>
<a name="line-368"></a> <span class='layout'>,</span> <span class='varid'>hasOption</span> <span class='varid'>a_output_xml</span> <span class='conop'>:-></span> <span class='layout'>(</span> <span class='varid'>escapeXmlDoc</span> <span class='comment'>-- escape lt, gt, amp, quot, </span>
<a name="line-369"></a> <span class='varop'>.></span>
<a name="line-370"></a> <span class='varid'>addXmlPiToDoc</span> <span class='comment'>-- add <?xml ... > pi</span>
<a name="line-371"></a> <span class='varop'>.></span>
<a name="line-372"></a> <span class='varid'>unparseXmlDoc</span> <span class='comment'>-- convert doc into text with respect to output encoding</span>
<a name="line-373"></a> <span class='layout'>)</span>
<a name="line-374"></a> <span class='layout'>,</span> <span class='varid'>this</span> <span class='conop'>:-></span> <span class='varid'>this</span>
<a name="line-375"></a> <span class='keyglyph'>]</span>
<a name="line-376"></a> <span class='layout'>)</span>
<a name="line-377"></a> <span class='varop'>.>></span>
<a name="line-378"></a> <span class='varid'>writeXmlDoc</span>
<a name="line-379"></a> <span class='varop'>.>></span>
<a name="line-380"></a> <span class='varid'>traceMsg</span> <span class='num'>1</span> <span class='str'>"writeDocument: finished"</span>
<a name="line-381"></a> <span class='layout'>)</span>
<a name="line-382"></a> <span class='keyword'>where</span>
<a name="line-383"></a> <span class='varid'>defaultOptions</span>
<a name="line-384"></a> <span class='keyglyph'>=</span> <span class='keyglyph'>[</span> <span class='layout'>(</span> <span class='varid'>a_output_file</span><span class='layout'>,</span> <span class='str'>"-"</span> <span class='layout'>)</span>
<a name="line-385"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_indent</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-386"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_remove_whitespace</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-387"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_output_xml</span><span class='layout'>,</span> <span class='varid'>v_1</span> <span class='layout'>)</span>
<a name="line-388"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_output_encoding</span><span class='layout'>,</span> <span class='varid'>utf8</span> <span class='layout'>)</span>
<a name="line-389"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_show_tree</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-390"></a> <span class='layout'>,</span> <span class='layout'>(</span> <span class='varid'>a_show_haskell</span><span class='layout'>,</span> <span class='varid'>v_0</span> <span class='layout'>)</span>
<a name="line-391"></a> <span class='keyglyph'>]</span>
<a name="line-392"></a>
<a name="line-393"></a><a name="writeXmlDoc"></a><span class='definition'>writeXmlDoc</span> <span class='keyglyph'>::</span> <span class='conid'>XmlStateFilter</span> <span class='varid'>state</span>
<a name="line-394"></a><span class='definition'>writeXmlDoc</span> <span class='varid'>t'</span>
<a name="line-395"></a> <span class='keyglyph'>=</span> <span class='varid'>put</span> <span class='varid'>t'</span>
<a name="line-396"></a> <span class='keyword'>where</span>
<a name="line-397"></a> <span class='varid'>put</span>
<a name="line-398"></a> <span class='keyglyph'>|</span> <span class='varid'>null</span> <span class='varid'>fn</span> <span class='varop'>||</span> <span class='varid'>fn</span> <span class='varop'>==</span> <span class='str'>"-"</span> <span class='keyglyph'>=</span> <span class='varid'>putXmlDoc</span>
<a name="line-399"></a> <span class='keyglyph'>|</span> <span class='varid'>otherwise</span> <span class='keyglyph'>=</span> <span class='varid'>putXmlDocToFile</span> <span class='varid'>fn</span>
<a name="line-400"></a>
<a name="line-401"></a> <span class='varid'>fn</span> <span class='keyglyph'>=</span> <span class='varid'>xshow</span> <span class='varop'>.</span> <span class='varid'>getValue</span> <span class='varid'>a_output_file</span> <span class='varop'>$</span> <span class='varid'>t'</span>
<a name="line-402"></a>
<a name="line-403"></a>
<a name="line-404"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-405"></a><span class='comment'>--</span>
<a name="line-406"></a>
<a name="line-407"></a><span class='comment'>-- |</span>
<a name="line-408"></a><span class='comment'>-- wrapper filter for running a monadic filter</span>
<a name="line-409"></a><span class='comment'>-- controlled by common options</span>
<a name="line-410"></a><span class='comment'>--</span>
<a name="line-411"></a><span class='comment'>-- input tree must be a complete document</span>
<a name="line-412"></a><span class='comment'>-- parameters and default parameters can be used to contol</span>
<a name="line-413"></a><span class='comment'>-- the filer and common tasks like error message handling</span>
<a name="line-414"></a>
<a name="line-415"></a><a name="processDocument"></a><span class='definition'>processDocument</span> <span class='keyglyph'>::</span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>Attributes</span> <span class='keyglyph'>-></span> <span class='conid'>XmlStateFilter</span> <span class='varid'>state</span> <span class='keyglyph'>-></span> <span class='conid'>XmlStateFilter</span> <span class='varid'>state</span>
<a name="line-416"></a><span class='definition'>processDocument</span> <span class='varid'>userOptions</span> <span class='varid'>defaultOptions</span> <span class='varid'>processFilter</span>
<a name="line-417"></a> <span class='keyglyph'>=</span> <span class='varid'>liftMf</span> <span class='varid'>isRoot</span>
<a name="line-418"></a> <span class='varop'>.>></span>
<a name="line-419"></a> <span class='varid'>liftMf</span> <span class='layout'>(</span><span class='varid'>addOptions</span> <span class='varid'>userOptions</span>
<a name="line-420"></a> <span class='varop'>.></span>
<a name="line-421"></a> <span class='varid'>addOptions</span> <span class='keyglyph'>[</span><span class='layout'>(</span><span class='varid'>a_status</span><span class='layout'>,</span> <span class='varid'>show</span> <span class='varid'>c_ok</span><span class='layout'>)</span><span class='keyglyph'>]</span>
<a name="line-422"></a> <span class='layout'>)</span>
<a name="line-423"></a> <span class='varop'>.>></span>
<a name="line-424"></a> <span class='varid'>liftMf</span> <span class='layout'>(</span><span class='varid'>addDefaultOptions</span> <span class='varid'>defaultOptions</span><span class='layout'>)</span>
<a name="line-425"></a> <span class='varop'>.>></span>
<a name="line-426"></a> <span class='varid'>setSystemParams</span> <span class='comment'>-- store options in system state</span>
<a name="line-427"></a> <span class='varop'>.>></span>
<a name="line-428"></a> <span class='varid'>choiceM</span>
<a name="line-429"></a> <span class='keyglyph'>[</span> <span class='varid'>hasOption</span> <span class='varid'>a_propagate_errors</span> <span class='comment'>-- error handling is set by calling environment</span>
<a name="line-430"></a> <span class='conop'>:-></span> <span class='varid'>thisM</span>
<a name="line-431"></a>
<a name="line-432"></a> <span class='layout'>,</span> <span class='varid'>hasOption</span> <span class='varid'>a_collect_errors</span>
<a name="line-433"></a> <span class='varop'>.></span>
<a name="line-434"></a> <span class='varid'>hasOption</span> <span class='varid'>a_issue_errors</span>
<a name="line-435"></a> <span class='conop'>:-></span> <span class='varid'>performAction</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='keyword'>_</span> <span class='keyglyph'>-></span> <span class='varid'>setSysErrorHandler</span> <span class='layout'>(</span><span class='varid'>errorMsgLogging</span><span class='varop'>.>></span> <span class='varid'>errorMsgToStderr</span><span class='layout'>)</span> <span class='layout'>)</span>
<a name="line-436"></a>
<a name="line-437"></a> <span class='layout'>,</span> <span class='varid'>hasOption</span> <span class='varid'>a_collect_errors</span>
<a name="line-438"></a> <span class='conop'>:-></span> <span class='varid'>performAction</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='keyword'>_</span> <span class='keyglyph'>-></span> <span class='varid'>setSysErrorHandler</span> <span class='varid'>errorMsgLogging</span> <span class='layout'>)</span>
<a name="line-439"></a>
<a name="line-440"></a> <span class='layout'>,</span> <span class='varid'>hasOption</span> <span class='varid'>a_issue_errors</span>
<a name="line-441"></a> <span class='conop'>:-></span> <span class='varid'>performAction</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='keyword'>_</span> <span class='keyglyph'>-></span> <span class='varid'>setSysErrorHandler</span> <span class='varid'>errorMsgToStderr</span> <span class='layout'>)</span>
<a name="line-442"></a>
<a name="line-443"></a> <span class='layout'>,</span> <span class='varid'>this</span>
<a name="line-444"></a> <span class='conop'>:-></span> <span class='varid'>performAction</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='keyword'>_</span> <span class='keyglyph'>-></span> <span class='varid'>setSysErrorHandler</span> <span class='varid'>noneM</span> <span class='layout'>)</span>
<a name="line-445"></a> <span class='keyglyph'>]</span>
<a name="line-446"></a> <span class='varop'>.>></span>
<a name="line-447"></a> <span class='varid'>processFilter</span>
<a name="line-448"></a> <span class='varop'>.>></span>
<a name="line-449"></a> <span class='layout'>(</span> <span class='varid'>thisM</span>
<a name="line-450"></a> <span class='varop'>+++>></span>
<a name="line-451"></a> <span class='layout'>(</span> <span class='varid'>hasOption</span> <span class='varid'>a_collect_errors</span>
<a name="line-452"></a> <span class='varop'>`guardsM`</span>
<a name="line-453"></a> <span class='varid'>getErrorMsg</span>
<a name="line-454"></a> <span class='layout'>)</span>
<a name="line-455"></a> <span class='layout'>)</span>
<a name="line-456"></a>
<a name="line-457"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-458"></a>
</pre></body>
</html>