packages feed

hxt-8.3.0: doc/hdoc/src/Text-XML-HXT-DOM-QualifiedName.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.DOM.QualifiedName
<a name="line-5"></a>   Copyright  : Copyright (C) 2008 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  : stable
<a name="line-10"></a>   Portability: portable
<a name="line-11"></a>
<a name="line-12"></a>   The core data types of the HXT DOM.
<a name="line-13"></a>
<a name="line-14"></a>-}</span>
<a name="line-15"></a>
<a name="line-16"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-17"></a>
<a name="line-18"></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'>DOM</span><span class='varop'>.</span><span class='conid'>QualifiedName</span>
<a name="line-19"></a>    <span class='layout'>(</span> <span class='conid'>QName</span>
<a name="line-20"></a>    <span class='layout'>,</span> <span class='conid'>XName</span>
<a name="line-21"></a>    <span class='layout'>,</span> <span class='conid'>NsEnv</span>
<a name="line-22"></a>
<a name="line-23"></a>    <span class='layout'>,</span> <span class='varid'>mkQName</span>
<a name="line-24"></a>    <span class='layout'>,</span> <span class='varid'>mkName</span>
<a name="line-25"></a>    <span class='layout'>,</span> <span class='varid'>mkNsName</span>
<a name="line-26"></a>    <span class='layout'>,</span> <span class='varid'>mkSNsName</span>
<a name="line-27"></a>    <span class='layout'>,</span> <span class='varid'>mkPrefixLocalPart</span>
<a name="line-28"></a>
<a name="line-29"></a>    <span class='layout'>,</span> <span class='varid'>equivQName</span>
<a name="line-30"></a>    <span class='layout'>,</span> <span class='varid'>equivUri</span>
<a name="line-31"></a>    <span class='layout'>,</span> <span class='varid'>equalQNameBy</span>
<a name="line-32"></a>
<a name="line-33"></a>    <span class='layout'>,</span> <span class='varid'>namePrefix</span>
<a name="line-34"></a>    <span class='layout'>,</span> <span class='varid'>localPart</span>
<a name="line-35"></a>    <span class='layout'>,</span> <span class='varid'>namespaceUri</span>
<a name="line-36"></a>
<a name="line-37"></a>    <span class='layout'>,</span> <span class='varid'>newXName</span>
<a name="line-38"></a>    <span class='layout'>,</span> <span class='varid'>nullXName</span>
<a name="line-39"></a>    <span class='layout'>,</span> <span class='varid'>isNullXName</span>
<a name="line-40"></a>
<a name="line-41"></a>    <span class='layout'>,</span> <span class='varid'>mkQName'</span>
<a name="line-42"></a>    <span class='layout'>,</span> <span class='varid'>namePrefix'</span>
<a name="line-43"></a>    <span class='layout'>,</span> <span class='varid'>localPart'</span>
<a name="line-44"></a>    <span class='layout'>,</span> <span class='varid'>namespaceUri'</span>
<a name="line-45"></a>
<a name="line-46"></a>    <span class='layout'>,</span> <span class='varid'>setNamePrefix'</span>
<a name="line-47"></a>    <span class='layout'>,</span> <span class='varid'>setLocalPart'</span>
<a name="line-48"></a>    <span class='layout'>,</span> <span class='varid'>setNamespaceUri'</span>
<a name="line-49"></a>
<a name="line-50"></a>    <span class='layout'>,</span> <span class='varid'>qualifiedName</span>
<a name="line-51"></a>    <span class='layout'>,</span> <span class='varid'>universalName</span>
<a name="line-52"></a>    <span class='layout'>,</span> <span class='varid'>universalUri</span>
<a name="line-53"></a>    <span class='layout'>,</span> <span class='varid'>buildUniversalName</span>
<a name="line-54"></a>
<a name="line-55"></a>    <span class='layout'>,</span> <span class='varid'>normalizeNsUri</span>
<a name="line-56"></a>
<a name="line-57"></a>    <span class='layout'>,</span> <span class='varid'>setNamespace</span>                      <span class='comment'>-- namespace related functions</span>
<a name="line-58"></a>    <span class='layout'>,</span> <span class='varid'>isNCName</span>
<a name="line-59"></a>    <span class='layout'>,</span> <span class='varid'>isWellformedQualifiedName</span>
<a name="line-60"></a>    <span class='layout'>,</span> <span class='varid'>isWellformedQName</span>
<a name="line-61"></a>    <span class='layout'>,</span> <span class='varid'>isWellformedNSDecl</span>
<a name="line-62"></a>    <span class='layout'>,</span> <span class='varid'>isWellformedNameSpaceName</span>
<a name="line-63"></a>    <span class='layout'>,</span> <span class='varid'>isNameSpaceName</span>
<a name="line-64"></a>    <span class='layout'>,</span> <span class='varid'>isDeclaredNamespace</span>
<a name="line-65"></a>
<a name="line-66"></a>    <span class='layout'>,</span> <span class='varid'>xmlNamespaceXName</span>
<a name="line-67"></a>    <span class='layout'>,</span> <span class='varid'>xmlXName</span>
<a name="line-68"></a>    <span class='layout'>,</span> <span class='varid'>xmlnsNamespaceXName</span>
<a name="line-69"></a>    <span class='layout'>,</span> <span class='varid'>xmlnsXName</span>
<a name="line-70"></a>    <span class='layout'>,</span> <span class='varid'>xmlnsQN</span>
<a name="line-71"></a>
<a name="line-72"></a>    <span class='layout'>,</span> <span class='varid'>toNsEnv</span>
<a name="line-73"></a>    <span class='layout'>)</span>
<a name="line-74"></a>
<a name="line-75"></a><span class='keyword'>where</span>
<a name="line-76"></a>
<a name="line-77"></a><span class='comment'>{-
<a name="line-78"></a>import           Debug.Trace
<a name="line-79"></a> -}</span>
<a name="line-80"></a>
<a name="line-81"></a><span class='keyword'>import</span>           <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Arrow</span>                  <span class='layout'>(</span> <span class='layout'>(</span><span class='varop'>***</span><span class='layout'>)</span> <span class='layout'>)</span>
<a name="line-82"></a>
<a name="line-83"></a><span class='keyword'>import</span>           <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Concurrent</span><span class='varop'>.</span><span class='conid'>MVar</span>
<a name="line-84"></a><span class='keyword'>import</span>           <span class='conid'>Control</span><span class='varop'>.</span><span class='conid'>Parallel</span><span class='varop'>.</span><span class='conid'>Strategies</span>
<a name="line-85"></a>
<a name="line-86"></a><span class='keyword'>import</span>           <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>AssocList</span>
<a name="line-87"></a><span class='keyword'>import</span>           <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>Char</span>                      <span class='layout'>(</span> <span class='varid'>toLower</span> <span class='layout'>)</span>
<a name="line-88"></a><span class='keyword'>import</span>           <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>List</span>                      <span class='layout'>(</span> <span class='varid'>isPrefixOf</span> <span class='layout'>)</span>
<a name="line-89"></a><span class='keyword'>import</span> <span class='keyword'>qualified</span> <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>Map</span>               <span class='keyword'>as</span> <span class='conid'>M</span>
<a name="line-90"></a><span class='keyword'>import</span>           <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>Maybe</span>
<a name="line-91"></a><span class='keyword'>import</span>           <span class='conid'>Data</span><span class='varop'>.</span><span class='conid'>Typeable</span>
<a name="line-92"></a>
<a name="line-93"></a><span class='keyword'>import</span>           <span class='conid'>System</span><span class='varop'>.</span><span class='conid'>IO</span><span class='varop'>.</span><span class='conid'>Unsafe</span>               <span class='layout'>(</span> <span class='varid'>unsafePerformIO</span> <span class='layout'>)</span>
<a name="line-94"></a>
<a name="line-95"></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'>XmlKeywords</span>   <span class='layout'>(</span> <span class='varid'>a_xml</span>
<a name="line-96"></a>                                                <span class='layout'>,</span> <span class='varid'>a_xmlns</span>
<a name="line-97"></a>                                                <span class='layout'>,</span> <span class='varid'>xmlNamespace</span>
<a name="line-98"></a>                                                <span class='layout'>,</span> <span class='varid'>xmlnsNamespace</span>
<a name="line-99"></a>                                                <span class='layout'>)</span>
<a name="line-100"></a>
<a name="line-101"></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'>Unicode</span>       <span class='layout'>(</span> <span class='varid'>isXmlNCNameStartChar</span>
<a name="line-102"></a>                                                <span class='layout'>,</span> <span class='varid'>isXmlNCNameChar</span>
<a name="line-103"></a>                                                <span class='layout'>)</span>
<a name="line-104"></a>
<a name="line-105"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-106"></a>
<a name="line-107"></a><span class='comment'>-- | XML names are represented by Strings, but these strings do not mix up with normal strings.</span>
<a name="line-108"></a><span class='comment'>-- Names are always reduced to normal form, and they are stored internally in a name cache</span>
<a name="line-109"></a><span class='comment'>-- for sharing equal names by the same data structure</span>
<a name="line-110"></a>
<a name="line-111"></a><a name="XName"></a><span class='keyword'>type</span> <span class='conid'>XName</span>      <span class='keyglyph'>=</span> <span class='conid'>Atom</span>
<a name="line-112"></a>
<a name="line-113"></a><span class='comment'>-- |</span>
<a name="line-114"></a><span class='comment'>-- Namespace support for element and attribute names.</span>
<a name="line-115"></a><span class='comment'>--</span>
<a name="line-116"></a><span class='comment'>-- A qualified name consists of a name prefix, a local name</span>
<a name="line-117"></a><span class='comment'>-- and a namespace uri.</span>
<a name="line-118"></a><span class='comment'>-- All modules, which are not namespace aware, use only the 'localPart' component.</span>
<a name="line-119"></a><span class='comment'>-- When dealing with namespaces, the document tree must be processed by "propagateNamespaces"</span>
<a name="line-120"></a><span class='comment'>-- to split names of structure \"prefix:localPart\" and label the name with the apropriate namespace uri</span>
<a name="line-121"></a>
<a name="line-122"></a><a name="QName"></a><span class='keyword'>data</span> <span class='conid'>QName</span>      <span class='keyglyph'>=</span> <span class='conid'>LP</span> <span class='varop'>!</span> <span class='conid'>XName</span>
<a name="line-123"></a>                <span class='keyglyph'>|</span> <span class='conid'>PX</span> <span class='varop'>!</span> <span class='conid'>XName</span> <span class='varop'>!</span> <span class='conid'>QName</span>
<a name="line-124"></a>                <span class='keyglyph'>|</span> <span class='conid'>NS</span> <span class='varop'>!</span> <span class='conid'>XName</span> <span class='varop'>!</span> <span class='conid'>QName</span>
<a name="line-125"></a>             <span class='keyword'>deriving</span> <span class='layout'>(</span><span class='conid'>Ord</span><span class='layout'>,</span> <span class='conid'>Show</span><span class='layout'>,</span> <span class='conid'>Read</span><span class='layout'>,</span> <span class='conid'>Typeable</span><span class='layout'>)</span>
<a name="line-126"></a>
<a name="line-127"></a><span class='comment'>-- |</span>
<a name="line-128"></a><span class='comment'>-- Type for the namespace association list, used when propagating namespaces by</span>
<a name="line-129"></a><span class='comment'>-- modifying the 'QName' values in a tree</span>
<a name="line-130"></a>
<a name="line-131"></a><a name="NsEnv"></a><span class='keyword'>type</span> <span class='conid'>NsEnv</span> <span class='keyglyph'>=</span> <span class='conid'>AssocList</span> <span class='conid'>XName</span> <span class='conid'>XName</span>
<a name="line-132"></a>
<a name="line-133"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-134"></a>
<a name="line-135"></a><span class='comment'>-- | Two QNames are equal if (1. case) namespaces are both empty and the qualified names</span>
<a name="line-136"></a><span class='comment'>-- (prefix:localpart) are the same or (2. case) namespaces are set and namespaces and</span>
<a name="line-137"></a><span class='comment'>-- local parts both are equal</span>
<a name="line-138"></a>    
<a name="line-139"></a><span class='keyword'>instance</span> <span class='conid'>Eq</span> <span class='conid'>QName</span> <span class='keyword'>where</span>
<a name="line-140"></a>    <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp1</span><span class='layout'>)</span>     <span class='varop'>==</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp2</span><span class='layout'>)</span>            <span class='keyglyph'>=</span> <span class='varid'>lp1</span> <span class='varop'>==</span> <span class='varid'>lp2</span>
<a name="line-141"></a>    <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px1</span> <span class='varid'>qn1</span><span class='layout'>)</span> <span class='varop'>==</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px2</span> <span class='varid'>qn2</span><span class='layout'>)</span>        <span class='keyglyph'>=</span> <span class='varid'>px1</span> <span class='varop'>==</span> <span class='varid'>px2</span> <span class='varop'>&amp;&amp;</span> <span class='varid'>qn1</span><span class='varop'>==</span> <span class='varid'>qn2</span>
<a name="line-142"></a>    <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns1</span> <span class='varid'>qn1</span><span class='layout'>)</span> <span class='varop'>==</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns2</span> <span class='varid'>qn2</span><span class='layout'>)</span>        <span class='keyglyph'>=</span> <span class='varid'>ns1</span> <span class='varop'>==</span> <span class='varid'>ns2</span> <span class='varop'>&amp;&amp;</span> <span class='varid'>localPart'</span> <span class='varid'>qn1</span> <span class='varop'>==</span> <span class='varid'>localPart'</span> <span class='varid'>qn2</span>
<a name="line-143"></a>    <span class='varid'>n1</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>PX</span> <span class='keyword'>_</span> <span class='keyword'>_</span><span class='layout'>)</span>  <span class='varop'>==</span> <span class='varid'>n2</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>           <span class='keyglyph'>=</span> <span class='varid'>qualifiedName</span> <span class='varid'>n1</span> <span class='varop'>==</span> <span class='varid'>qualifiedName</span> <span class='varid'>n2</span>
<a name="line-144"></a>    <span class='varid'>n1</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>    <span class='varop'>==</span> <span class='varid'>n2</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>PX</span> <span class='keyword'>_</span> <span class='keyword'>_</span><span class='layout'>)</span>         <span class='keyglyph'>=</span> <span class='varid'>qualifiedName</span> <span class='varid'>n1</span> <span class='varop'>==</span> <span class='varid'>qualifiedName</span> <span class='varid'>n2</span>
<a name="line-145"></a>    <span class='keyword'>_</span>            <span class='varop'>==</span> <span class='keyword'>_</span>                   <span class='keyglyph'>=</span> <span class='conid'>False</span>
<a name="line-146"></a>
<a name="line-147"></a><span class='comment'>-- the 4. and 5. rule are only neccessary when someone</span>
<a name="line-148"></a><span class='comment'>-- uses XML names not in a systematical way</span>
<a name="line-149"></a><span class='comment'>-- and does things like "mkName("x:y") == mkPrefixLocalPart("x","y")</span>
<a name="line-150"></a>
<a name="line-151"></a><span class='keyword'>instance</span> <span class='conid'>NFData</span> <span class='conid'>QName</span> <span class='keyword'>where</span>
<a name="line-152"></a>
<a name="line-153"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-154"></a>
<a name="line-155"></a><a name="newXName"></a><span class='definition'>newXName</span>                <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span>
<a name="line-156"></a><span class='definition'>newXName</span>                <span class='keyglyph'>=</span> <span class='varid'>newAtom</span>
<a name="line-157"></a>
<a name="line-158"></a><a name="isNullXName"></a><span class='definition'>isNullXName</span>             <span class='keyglyph'>::</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-159"></a><span class='definition'>isNullXName</span>             <span class='keyglyph'>=</span> <span class='layout'>(</span><span class='varop'>==</span> <span class='varid'>nullXName</span><span class='layout'>)</span>
<a name="line-160"></a>
<a name="line-161"></a><a name="nullXName"></a><span class='definition'>nullXName</span>               <span class='keyglyph'>::</span> <span class='conid'>XName</span>
<a name="line-162"></a><span class='definition'>nullXName</span>               <span class='keyglyph'>=</span> <span class='varid'>newXName</span> <span class='str'>""</span>
<a name="line-163"></a>
<a name="line-164"></a><span class='comment'>-- | access name prefix</span>
<a name="line-165"></a>
<a name="line-166"></a><a name="namePrefix'"></a><span class='definition'>namePrefix'</span>             <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span>
<a name="line-167"></a><span class='definition'>namePrefix'</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='varid'>nullXName</span>
<a name="line-168"></a><span class='definition'>namePrefix'</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='keyword'>_</span><span class='layout'>)</span>   <span class='keyglyph'>=</span> <span class='varid'>px</span>
<a name="line-169"></a><span class='definition'>namePrefix'</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>    <span class='keyglyph'>=</span> <span class='varid'>namePrefix'</span> <span class='varid'>n</span>
<a name="line-170"></a>
<a name="line-171"></a><span class='comment'>-- | access local part</span>
<a name="line-172"></a>
<a name="line-173"></a><a name="localPart'"></a><span class='definition'>localPart'</span>              <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span>
<a name="line-174"></a><span class='definition'>localPart'</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='varid'>lp</span>
<a name="line-175"></a><span class='definition'>localPart'</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>     <span class='keyglyph'>=</span> <span class='varid'>localPart'</span> <span class='varid'>n</span>
<a name="line-176"></a><span class='definition'>localPart'</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>     <span class='keyglyph'>=</span> <span class='varid'>localPart'</span> <span class='varid'>n</span>
<a name="line-177"></a>
<a name="line-178"></a><span class='comment'>-- | access namespace uri</span>
<a name="line-179"></a>
<a name="line-180"></a><a name="namespaceUri'"></a><span class='definition'>namespaceUri'</span>           <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span>
<a name="line-181"></a><span class='definition'>namespaceUri'</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns</span> <span class='keyword'>_</span><span class='layout'>)</span> <span class='keyglyph'>=</span> <span class='varid'>ns</span>
<a name="line-182"></a><span class='definition'>namespaceUri'</span> <span class='keyword'>_</span>         <span class='keyglyph'>=</span> <span class='varid'>nullXName</span>
<a name="line-183"></a>
<a name="line-184"></a><a name="namePrefix"></a><span class='definition'>namePrefix</span>              <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-185"></a><span class='definition'>namePrefix</span>              <span class='keyglyph'>=</span> <span class='varid'>show</span> <span class='varop'>.</span> <span class='varid'>namePrefix'</span>
<a name="line-186"></a>
<a name="line-187"></a><a name="localPart"></a><span class='definition'>localPart</span>               <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-188"></a><span class='definition'>localPart</span>               <span class='keyglyph'>=</span> <span class='varid'>show</span> <span class='varop'>.</span> <span class='varid'>localPart'</span>
<a name="line-189"></a>
<a name="line-190"></a><a name="namespaceUri"></a><span class='definition'>namespaceUri</span>            <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-191"></a><span class='definition'>namespaceUri</span>            <span class='keyglyph'>=</span> <span class='varid'>show</span> <span class='varop'>.</span> <span class='varid'>namespaceUri'</span>
<a name="line-192"></a>
<a name="line-193"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-194"></a>
<a name="line-195"></a><span class='comment'>-- | set name prefix</span>
<a name="line-196"></a>
<a name="line-197"></a><a name="setNamespaceUri'"></a><span class='definition'>setNamespaceUri'</span>                <span class='keyglyph'>::</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-198"></a><span class='definition'>setNamespaceUri'</span> <span class='varid'>ns</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>    <span class='keyglyph'>=</span> <span class='keyword'>if</span> <span class='varid'>isNullXName</span> <span class='varid'>ns</span>
<a name="line-199"></a>                                  <span class='keyword'>then</span> <span class='varid'>n</span>
<a name="line-200"></a>                                  <span class='keyword'>else</span> <span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n</span>
<a name="line-201"></a><span class='definition'>setNamespaceUri'</span> <span class='varid'>ns</span> <span class='varid'>n</span>           <span class='keyglyph'>=</span> <span class='keyword'>if</span> <span class='varid'>isNullXName</span> <span class='varid'>ns</span>
<a name="line-202"></a>                                  <span class='keyword'>then</span> <span class='varid'>n</span>
<a name="line-203"></a>                                  <span class='keyword'>else</span> <span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n</span>
<a name="line-204"></a>
<a name="line-205"></a><span class='comment'>-- | set local part</span>
<a name="line-206"></a>
<a name="line-207"></a><a name="setLocalPart'"></a><span class='definition'>setLocalPart'</span>                   <span class='keyglyph'>::</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-208"></a><span class='definition'>setLocalPart'</span> <span class='varid'>lp</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>         <span class='keyglyph'>=</span> <span class='conid'>LP</span> <span class='varid'>lp</span>
<a name="line-209"></a><span class='definition'>setLocalPart'</span> <span class='varid'>lp</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='varid'>n</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='conid'>PX</span> <span class='varid'>px</span> <span class='layout'>(</span><span class='varid'>setLocalPart'</span> <span class='varid'>lp</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-210"></a><span class='definition'>setLocalPart'</span> <span class='varid'>lp</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='conid'>NS</span> <span class='varid'>ns</span> <span class='layout'>(</span><span class='varid'>setLocalPart'</span> <span class='varid'>lp</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-211"></a>
<a name="line-212"></a><span class='comment'>-- | set name prefix</span>
<a name="line-213"></a>
<a name="line-214"></a><a name="setNamePrefix'"></a><span class='definition'>setNamePrefix'</span>                  <span class='keyglyph'>::</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-215"></a><span class='definition'>setNamePrefix'</span> <span class='varid'>px</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='keyword'>if</span> <span class='varid'>px</span> <span class='varop'>==</span> <span class='varid'>nullXName</span>
<a name="line-216"></a>                                  <span class='keyword'>then</span> <span class='varid'>n</span>
<a name="line-217"></a>                                  <span class='keyword'>else</span> <span class='conid'>PX</span> <span class='varid'>px</span> <span class='varid'>n</span>
<a name="line-218"></a><span class='definition'>setNamePrefix'</span> <span class='varid'>px</span> <span class='varid'>n</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='keyword'>if</span> <span class='varid'>px</span> <span class='varop'>==</span> <span class='varid'>nullXName</span>
<a name="line-219"></a>                                  <span class='keyword'>then</span> <span class='varid'>n</span>
<a name="line-220"></a>                                  <span class='keyword'>else</span> <span class='conid'>PX</span> <span class='varid'>px</span> <span class='varid'>n</span>
<a name="line-221"></a><span class='definition'>setNamePrefix'</span> <span class='varid'>px</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n</span><span class='layout'>)</span>     <span class='keyglyph'>=</span> <span class='conid'>NS</span> <span class='varid'>ns</span> <span class='layout'>(</span><span class='varid'>setNamePrefix'</span> <span class='varid'>px</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-222"></a>
<a name="line-223"></a>
<a name="line-224"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-225"></a>
<a name="line-226"></a><span class='comment'>-- |</span>
<a name="line-227"></a><span class='comment'>-- builds the full name \"prefix:localPart\", if prefix is not null, else the local part is the result</span>
<a name="line-228"></a>
<a name="line-229"></a><a name="qualifiedName"></a><span class='definition'>qualifiedName</span>                   <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-230"></a><span class='definition'>qualifiedName</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp</span><span class='layout'>)</span>           <span class='keyglyph'>=</span> <span class='varid'>show</span> <span class='varid'>lp</span>
<a name="line-231"></a><span class='definition'>qualifiedName</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='varid'>n</span><span class='layout'>)</span>         <span class='keyglyph'>=</span> <span class='varid'>show</span> <span class='varid'>px</span> <span class='varop'>++</span> <span class='layout'>(</span><span class='chr'>':'</span> <span class='conop'>:</span> <span class='varid'>qualifiedName</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-232"></a><span class='definition'>qualifiedName</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>          <span class='keyglyph'>=</span> <span class='varid'>qualifiedName</span> <span class='varid'>n</span>
<a name="line-233"></a>
<a name="line-234"></a><span class='comment'>-- |</span>
<a name="line-235"></a><span class='comment'>-- builds the \"universal\" name, that is the namespace uri surrounded with \"{\" and \"}\" followed by the local part</span>
<a name="line-236"></a><span class='comment'>-- (specialisation of 'buildUniversalName')</span>
<a name="line-237"></a>
<a name="line-238"></a><a name="universalName"></a><span class='definition'>universalName</span>                   <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-239"></a><span class='definition'>universalName</span>                   <span class='keyglyph'>=</span> <span class='varid'>buildUniversalName</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>ns</span> <span class='varid'>lp</span> <span class='keyglyph'>-&gt;</span> <span class='chr'>'{'</span> <span class='conop'>:</span> <span class='varid'>ns</span> <span class='varop'>++</span> <span class='chr'>'}'</span> <span class='conop'>:</span> <span class='varid'>lp</span><span class='layout'>)</span>
<a name="line-240"></a>
<a name="line-241"></a><span class='comment'>-- |</span>
<a name="line-242"></a><span class='comment'>-- builds an \"universal\" uri, that is the namespace uri followed by the local part. This is usefull for RDF applications,</span>
<a name="line-243"></a><span class='comment'>-- where the subject, predicate and object often are concatenated from namespace uri and local part</span>
<a name="line-244"></a><span class='comment'>-- (specialisation of 'buildUniversalName')</span>
<a name="line-245"></a>
<a name="line-246"></a><a name="universalUri"></a><span class='definition'>universalUri</span>                    <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-247"></a><span class='definition'>universalUri</span>                    <span class='keyglyph'>=</span> <span class='varid'>buildUniversalName</span> <span class='layout'>(</span><span class='varop'>++</span><span class='layout'>)</span>
<a name="line-248"></a>
<a name="line-249"></a><span class='comment'>-- |</span>
<a name="line-250"></a><span class='comment'>-- builds a string from the namespace uri and the local part. If the namespace uri is empty, the local part is returned, else</span>
<a name="line-251"></a><span class='comment'>-- namespace uri and local part are combined with the combining function given by the first parameter</span>
<a name="line-252"></a>
<a name="line-253"></a><a name="buildUniversalName"></a><span class='definition'>buildUniversalName</span>              <span class='keyglyph'>::</span> <span class='layout'>(</span><span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span><span class='layout'>)</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-254"></a><span class='definition'>buildUniversalName</span> <span class='varid'>bf</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n</span><span class='layout'>)</span> <span class='keyglyph'>=</span> <span class='varid'>show</span> <span class='varid'>ns</span> <span class='varop'>`bf`</span> <span class='varid'>localPart</span> <span class='varid'>n</span>
<a name="line-255"></a><span class='definition'>buildUniversalName</span> <span class='keyword'>_</span>  <span class='varid'>n</span>         <span class='keyglyph'>=</span> <span class='varid'>localPart</span> <span class='varid'>n</span>
<a name="line-256"></a>
<a name="line-257"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-258"></a><span class='comment'>--</span>
<a name="line-259"></a><span class='comment'>-- internal XName functions</span>
<a name="line-260"></a>
<a name="line-261"></a><a name="mkQName'"></a><span class='definition'>mkQName'</span>                        <span class='keyglyph'>::</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-262"></a><span class='definition'>mkQName'</span> <span class='varid'>px</span> <span class='varid'>lp</span> <span class='varid'>ns</span>
<a name="line-263"></a>    <span class='keyglyph'>|</span> <span class='varid'>isNullXName</span> <span class='varid'>ns</span>            <span class='keyglyph'>=</span>       <span class='varid'>px_lp</span>
<a name="line-264"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>px_lp</span>
<a name="line-265"></a>    <span class='keyword'>where</span>
<a name="line-266"></a>    <span class='varid'>px_lp</span>
<a name="line-267"></a>        <span class='keyglyph'>|</span> <span class='varid'>isNullXName</span> <span class='varid'>px</span>        <span class='keyglyph'>=</span> <span class='conid'>LP</span> <span class='varid'>lp</span>
<a name="line-268"></a>        <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>             <span class='keyglyph'>=</span> <span class='conid'>PX</span> <span class='varid'>px</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp</span><span class='layout'>)</span>
<a name="line-269"></a>
<a name="line-270"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-271"></a>
<a name="line-272"></a><span class='comment'>-- |</span>
<a name="line-273"></a><span class='comment'>-- constructs a simple name, with prefix and localPart but without a namespace uri.</span>
<a name="line-274"></a><span class='comment'>--</span>
<a name="line-275"></a><span class='comment'>-- see also 'mkQName', 'mkName'</span>
<a name="line-276"></a>
<a name="line-277"></a><a name="mkPrefixLocalPart"></a><span class='definition'>mkPrefixLocalPart</span>               <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-278"></a><span class='definition'>mkPrefixLocalPart</span> <span class='varid'>px</span> <span class='varid'>lp</span>
<a name="line-279"></a>    <span class='keyglyph'>|</span> <span class='varid'>null</span> <span class='varid'>px</span>                   <span class='keyglyph'>=</span>                  <span class='varid'>n1</span>
<a name="line-280"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='conid'>PX</span> <span class='layout'>(</span><span class='varid'>newXName</span> <span class='varid'>px</span><span class='layout'>)</span> <span class='varid'>n1</span>
<a name="line-281"></a>    <span class='keyword'>where</span>
<a name="line-282"></a>    <span class='varid'>n1</span> <span class='keyglyph'>=</span> <span class='conid'>LP</span> <span class='layout'>(</span><span class='varid'>newXName</span> <span class='varid'>lp</span><span class='layout'>)</span>
<a name="line-283"></a>
<a name="line-284"></a><span class='comment'>-- |</span>
<a name="line-285"></a><span class='comment'>-- constructs a simple, namespace unaware name.</span>
<a name="line-286"></a><span class='comment'>-- If the name is in @prefix:localpart@ form and the prefix is not empty</span>
<a name="line-287"></a><span class='comment'>-- the name is split internally into</span>
<a name="line-288"></a><span class='comment'>-- a prefix and a local part.</span>
<a name="line-289"></a>
<a name="line-290"></a><a name="mkName"></a><span class='definition'>mkName</span>                          <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-291"></a><span class='definition'>mkName</span> <span class='varid'>n</span>                        
<a name="line-292"></a>    <span class='keyglyph'>|</span> <span class='layout'>(</span><span class='chr'>':'</span> <span class='varop'>`elem`</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-293"></a>      <span class='varop'>&amp;&amp;</span>
<a name="line-294"></a>      <span class='varid'>not</span> <span class='layout'>(</span><span class='varid'>null</span> <span class='varid'>px</span><span class='layout'>)</span>			<span class='comment'>-- more restrictive: isWellformedQualifiedName n</span>
<a name="line-295"></a>                                <span class='keyglyph'>=</span> <span class='varid'>mkPrefixLocalPart</span> <span class='varid'>px</span> <span class='varid'>lp</span>
<a name="line-296"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='varid'>mkPrefixLocalPart</span> <span class='str'>""</span> <span class='varid'>n</span>
<a name="line-297"></a>    <span class='keyword'>where</span>
<a name="line-298"></a>    <span class='layout'>(</span><span class='varid'>px</span><span class='layout'>,</span> <span class='layout'>(</span><span class='keyword'>_</span><span class='conop'>:</span><span class='varid'>lp</span><span class='layout'>)</span><span class='layout'>)</span> <span class='keyglyph'>=</span> <span class='varid'>span</span> <span class='layout'>(</span><span class='varop'>/=</span> <span class='chr'>':'</span><span class='layout'>)</span> <span class='varid'>n</span>
<a name="line-299"></a>
<a name="line-300"></a><span class='comment'>-- |</span>
<a name="line-301"></a><span class='comment'>-- constructs a complete qualified name with 'namePrefix', 'localPart' and 'namespaceUri'.</span>
<a name="line-302"></a><span class='comment'>-- This function can be used to build not wellformed prefix:localpart names.</span>
<a name="line-303"></a><span class='comment'>-- The XPath module uses wildcard names like @xxx:*@. These must be build with 'mkQName'</span>
<a name="line-304"></a><span class='comment'>-- and not with mkName.</span>
<a name="line-305"></a>
<a name="line-306"></a><a name="mkQName"></a><span class='definition'>mkQName</span>                         <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-307"></a><span class='definition'>mkQName</span> <span class='varid'>px</span> <span class='varid'>lp</span> <span class='varid'>ns</span>
<a name="line-308"></a>    <span class='keyglyph'>|</span> <span class='varid'>null</span> <span class='varid'>ns</span>                   <span class='keyglyph'>=</span>                  <span class='varid'>n1</span>
<a name="line-309"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='conid'>NS</span> <span class='layout'>(</span><span class='varid'>newXName</span> <span class='varid'>ns</span><span class='layout'>)</span> <span class='varid'>n1</span>
<a name="line-310"></a>    <span class='keyword'>where</span>
<a name="line-311"></a>    <span class='varid'>n1</span> <span class='keyglyph'>=</span> <span class='varid'>mkPrefixLocalPart</span> <span class='varid'>px</span> <span class='varid'>lp</span>
<a name="line-312"></a>
<a name="line-313"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-314"></a>
<a name="line-315"></a><span class='comment'>-- |</span>
<a name="line-316"></a><span class='comment'>-- old name for 'mkName'</span>
<a name="line-317"></a>
<a name="line-318"></a><a name="mkSNsName"></a><span class='definition'>mkSNsName</span>                       <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-319"></a><span class='definition'>mkSNsName</span>                       <span class='keyglyph'>=</span> <span class='varid'>mkName</span>
<a name="line-320"></a>
<a name="line-321"></a><span class='comment'>-- |</span>
<a name="line-322"></a><span class='comment'>-- constructs a simple, namespace aware name, with prefix:localPart as first parameter,</span>
<a name="line-323"></a><span class='comment'>-- namspace uri as second.</span>
<a name="line-324"></a><span class='comment'>--</span>
<a name="line-325"></a><span class='comment'>-- see also 'mkName', 'mkPrefixLocalPart'</span>
<a name="line-326"></a>
<a name="line-327"></a><a name="mkNsName"></a><span class='definition'>mkNsName</span>                        <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-328"></a><span class='definition'>mkNsName</span> <span class='varid'>n</span> <span class='varid'>ns</span>
<a name="line-329"></a>    <span class='keyglyph'>|</span> <span class='varid'>null</span> <span class='varid'>ns</span>                   <span class='keyglyph'>=</span>                   <span class='varid'>mkName</span> <span class='varid'>n</span>
<a name="line-330"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='conid'>NS</span> <span class='layout'>(</span><span class='varid'>newXName</span> <span class='varid'>ns</span><span class='layout'>)</span> <span class='layout'>(</span><span class='varid'>mkName</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-331"></a>
<a name="line-332"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-333"></a>
<a name="line-334"></a><span class='comment'>-- | Equivalent QNames are defined as follows: The URIs are normalized before comparison.</span>
<a name="line-335"></a><span class='comment'>-- Comparison is done with 'equalQNameBy' and 'equivUri'</span>
<a name="line-336"></a>
<a name="line-337"></a><a name="equivQName"></a><span class='definition'>equivQName</span>                      <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-338"></a><span class='definition'>equivQName</span>                      <span class='keyglyph'>=</span> <span class='varid'>equalQNameBy</span> <span class='varid'>equivUri</span>
<a name="line-339"></a>
<a name="line-340"></a><span class='comment'>-- | Comparison of normalized namespace URIs using 'normalizeNsUri'</span>
<a name="line-341"></a>
<a name="line-342"></a><a name="equivUri"></a><span class='definition'>equivUri</span>                        <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-343"></a><span class='definition'>equivUri</span> <span class='varid'>x</span> <span class='varid'>y</span>                    <span class='keyglyph'>=</span> <span class='varid'>normalizeNsUri</span> <span class='varid'>x</span> <span class='varop'>==</span> <span class='varid'>normalizeNsUri</span> <span class='varid'>y</span>
<a name="line-344"></a>
<a name="line-345"></a><span class='comment'>-- | Sometimes a weaker equality relation than 'equalQName' is appropriate, e.g no case significance in names, ...</span>
<a name="line-346"></a><span class='comment'>-- a name normalization function can be applied to the strings before comparing. Called by 'equalQName' and</span>
<a name="line-347"></a><span class='comment'>-- 'equivQName'</span>
<a name="line-348"></a>
<a name="line-349"></a><a name="equalQNameBy"></a><span class='definition'>equalQNameBy</span>                    <span class='keyglyph'>::</span> <span class='layout'>(</span><span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span><span class='layout'>)</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-350"></a><span class='definition'>equalQNameBy</span> <span class='varid'>equiv</span> <span class='varid'>q1</span> <span class='varid'>q2</span>        <span class='keyglyph'>=</span> <span class='varid'>localPart</span> <span class='varid'>q1</span> <span class='varop'>==</span> <span class='varid'>localPart</span> <span class='varid'>q2</span>
<a name="line-351"></a>                                  <span class='varop'>&amp;&amp;</span>
<a name="line-352"></a>                                  <span class='layout'>(</span><span class='varid'>namespaceUri</span> <span class='varid'>q1</span> <span class='varop'>`equiv`</span> <span class='varid'>namespaceUri</span> <span class='varid'>q2</span><span class='layout'>)</span>
<a name="line-353"></a>
<a name="line-354"></a><span class='comment'>-- |  Normalization of URIs: Normalization is done by conversion into lowercase letters. A trailing \"\/\" is ignored</span>
<a name="line-355"></a>
<a name="line-356"></a><a name="normalizeNsUri"></a><span class='definition'>normalizeNsUri</span>                  <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>String</span>
<a name="line-357"></a><span class='definition'>normalizeNsUri</span>                  <span class='keyglyph'>=</span> <span class='varid'>map</span> <span class='varid'>toLower</span> <span class='varop'>.</span> <span class='varid'>stripSlash</span>
<a name="line-358"></a>    <span class='keyword'>where</span>
<a name="line-359"></a>    <span class='varid'>stripSlash</span> <span class='str'>""</span>               <span class='keyglyph'>=</span> <span class='str'>""</span>
<a name="line-360"></a>    <span class='varid'>stripSlash</span> <span class='varid'>s</span>
<a name="line-361"></a>        <span class='keyglyph'>|</span> <span class='varid'>last</span> <span class='varid'>s</span> <span class='varop'>==</span> <span class='chr'>'/'</span>         <span class='keyglyph'>=</span> <span class='varid'>init</span> <span class='varid'>s</span>
<a name="line-362"></a>        <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>             <span class='keyglyph'>=</span> <span class='varid'>s</span>
<a name="line-363"></a>
<a name="line-364"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-365"></a>
<a name="line-366"></a><span class='comment'>-- Namespace predicates</span>
<a name="line-367"></a>
<a name="line-368"></a><span class='comment'>-- |</span>
<a name="line-369"></a><span class='comment'>-- Compute the name prefix and the namespace uri for a qualified name.</span>
<a name="line-370"></a><span class='comment'>--</span>
<a name="line-371"></a><span class='comment'>-- This function does not test whether the name is a wellformed qualified name.</span>
<a name="line-372"></a><span class='comment'>-- see Namespaces in XML Rule [6] to [8]. Error checking is done with separate functions,</span>
<a name="line-373"></a><span class='comment'>-- see 'isWellformedQName' and 'isWellformedQualifiedName' for error checking.</span>
<a name="line-374"></a>
<a name="line-375"></a><a name="setNamespace"></a><span class='definition'>setNamespace</span>                    <span class='keyglyph'>::</span> <span class='conid'>NsEnv</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-376"></a><span class='definition'>setNamespace</span> <span class='varid'>env</span> <span class='varid'>n</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='keyword'>_</span><span class='layout'>)</span>    <span class='keyglyph'>=</span> <span class='varid'>attachNS</span> <span class='varid'>env</span> <span class='varid'>px</span>        <span class='varid'>n</span>              <span class='comment'>-- none empty prefix found</span>
<a name="line-377"></a><span class='definition'>setNamespace</span> <span class='varid'>env</span> <span class='varid'>n</span><span class='keyglyph'>@</span><span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>       <span class='keyglyph'>=</span> <span class='varid'>attachNS</span> <span class='varid'>env</span> <span class='varid'>nullXName</span> <span class='varid'>n</span>              <span class='comment'>-- use default namespace uri</span>
<a name="line-378"></a><span class='definition'>setNamespace</span> <span class='varid'>env</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>       <span class='keyglyph'>=</span> <span class='varid'>setNamespace</span> <span class='varid'>env</span> <span class='varid'>n</span>
<a name="line-379"></a>
<a name="line-380"></a><a name="attachNS"></a><span class='definition'>attachNS</span>                        <span class='keyglyph'>::</span> <span class='conid'>NsEnv</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span>
<a name="line-381"></a><span class='definition'>attachNS</span> <span class='varid'>env</span> <span class='varid'>px</span> <span class='varid'>n1</span>              <span class='keyglyph'>=</span> <span class='varid'>maybe</span> <span class='varid'>n1</span> <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>ns</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n1</span><span class='layout'>)</span> <span class='varop'>.</span> <span class='varid'>lookup</span> <span class='varid'>px</span> <span class='varop'>$</span> <span class='varid'>env</span>
<a name="line-382"></a>
<a name="line-383"></a><a name="xmlnsNamespaceXName"></a><span class='definition'>xmlnsNamespaceXName</span>             <span class='keyglyph'>::</span> <span class='conid'>XName</span>
<a name="line-384"></a><span class='definition'>xmlnsNamespaceXName</span>             <span class='keyglyph'>=</span> <span class='varid'>newXName</span> <span class='varid'>xmlnsNamespace</span>
<a name="line-385"></a>
<a name="line-386"></a><a name="xmlnsXName"></a><span class='definition'>xmlnsXName</span>                      <span class='keyglyph'>::</span> <span class='conid'>XName</span>
<a name="line-387"></a><span class='definition'>xmlnsXName</span>                      <span class='keyglyph'>=</span> <span class='varid'>newXName</span> <span class='varid'>a_xmlns</span>
<a name="line-388"></a>
<a name="line-389"></a><a name="xmlnsQN"></a><span class='definition'>xmlnsQN</span>                         <span class='keyglyph'>::</span> <span class='conid'>QName</span>
<a name="line-390"></a><span class='definition'>xmlnsQN</span>                         <span class='keyglyph'>=</span> <span class='conid'>NS</span> <span class='varid'>xmlnsNamespaceXName</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>xmlnsXName</span><span class='layout'>)</span>
<a name="line-391"></a>
<a name="line-392"></a><a name="xmlNamespaceXName"></a><span class='definition'>xmlNamespaceXName</span>               <span class='keyglyph'>::</span> <span class='conid'>XName</span>
<a name="line-393"></a><span class='definition'>xmlNamespaceXName</span>               <span class='keyglyph'>=</span> <span class='varid'>newXName</span> <span class='varid'>xmlNamespace</span>
<a name="line-394"></a>
<a name="line-395"></a><a name="xmlXName"></a><span class='definition'>xmlXName</span>                        <span class='keyglyph'>::</span> <span class='conid'>XName</span>
<a name="line-396"></a><span class='definition'>xmlXName</span>                        <span class='keyglyph'>=</span> <span class='varid'>newXName</span> <span class='varid'>a_xml</span>
<a name="line-397"></a>
<a name="line-398"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-399"></a><span class='comment'>--</span>
<a name="line-400"></a>
<a name="line-401"></a><span class='comment'>-- |</span>
<a name="line-402"></a><span class='comment'>-- test for wellformed NCName, rule [4] XML Namespaces</span>
<a name="line-403"></a>
<a name="line-404"></a><a name="isNCName"></a><span class='definition'>isNCName</span>                        <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-405"></a><span class='definition'>isNCName</span> <span class='conid'>[]</span>                     <span class='keyglyph'>=</span> <span class='conid'>False</span>
<a name="line-406"></a><span class='definition'>isNCName</span> <span class='varid'>n</span>                      <span class='keyglyph'>=</span> <span class='varid'>and</span> <span class='layout'>(</span> <span class='varid'>zipWith</span> <span class='layout'>(</span><span class='varop'>$</span><span class='layout'>)</span>
<a name="line-407"></a>                                        <span class='layout'>(</span><span class='varid'>isXmlNCNameStartChar</span> <span class='conop'>:</span> <span class='varid'>repeat</span> <span class='varid'>isXmlNCNameChar</span><span class='layout'>)</span>
<a name="line-408"></a>                                        <span class='varid'>n</span>
<a name="line-409"></a>                                      <span class='layout'>)</span>
<a name="line-410"></a>
<a name="line-411"></a><span class='comment'>-- |</span>
<a name="line-412"></a><span class='comment'>-- test for wellformed QName, rule [6] XML Namespaces</span>
<a name="line-413"></a><span class='comment'>-- predicate is used in filter 'valdateNamespaces'.</span>
<a name="line-414"></a>
<a name="line-415"></a><a name="isWellformedQualifiedName"></a><span class='definition'>isWellformedQualifiedName</span>       <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-416"></a><span class='definition'>isWellformedQualifiedName</span> <span class='varid'>s</span>
<a name="line-417"></a>    <span class='keyglyph'>|</span> <span class='varid'>null</span> <span class='varid'>lp</span>                   <span class='keyglyph'>=</span> <span class='varid'>isNCName</span> <span class='varid'>px</span>
<a name="line-418"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='varid'>isNCName</span> <span class='varid'>px</span> <span class='varop'>&amp;&amp;</span> <span class='varid'>isNCName</span> <span class='layout'>(</span><span class='varid'>tail</span> <span class='varid'>lp</span><span class='layout'>)</span>
<a name="line-419"></a>    <span class='keyword'>where</span>
<a name="line-420"></a>    <span class='layout'>(</span><span class='varid'>px</span><span class='layout'>,</span> <span class='varid'>lp</span><span class='layout'>)</span>                    <span class='keyglyph'>=</span> <span class='varid'>span</span> <span class='layout'>(</span><span class='varop'>/=</span> <span class='chr'>':'</span><span class='layout'>)</span> <span class='varid'>s</span>
<a name="line-421"></a>
<a name="line-422"></a><span class='comment'>-- |</span>
<a name="line-423"></a><span class='comment'>-- test for wellformed QName values.</span>
<a name="line-424"></a><span class='comment'>-- A QName is wellformed, if the local part is a NCName, the namePrefix, if not empty, is also a NCName.</span>
<a name="line-425"></a><span class='comment'>-- predicate is used in filter 'valdateNamespaces'.</span>
<a name="line-426"></a>
<a name="line-427"></a><a name="isWellformedQName"></a><span class='definition'>isWellformedQName</span>               <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-428"></a><span class='definition'>isWellformedQName</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp</span><span class='layout'>)</span>       <span class='keyglyph'>=</span> <span class='varid'>isNCName</span> <span class='varop'>.</span> <span class='varid'>show</span> <span class='varop'>$</span> <span class='varid'>lp</span>                          <span class='comment'>-- rule [8] XML Namespaces</span>
<a name="line-429"></a><span class='definition'>isWellformedQName</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='varid'>n</span><span class='layout'>)</span>     <span class='keyglyph'>=</span> <span class='layout'>(</span><span class='varid'>isNCName</span> <span class='varop'>.</span> <span class='varid'>show</span><span class='layout'>)</span> <span class='varid'>px</span>                          <span class='comment'>-- rule [7] XML Namespaces</span>
<a name="line-430"></a>                                  <span class='varop'>&amp;&amp;</span>
<a name="line-431"></a>                                  <span class='varid'>isWellformedQName</span> <span class='varid'>n</span>
<a name="line-432"></a><span class='definition'>isWellformedQName</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='varid'>isWellformedQName</span> <span class='varid'>n</span>
<a name="line-433"></a>
<a name="line-434"></a><span class='comment'>-- |</span>
<a name="line-435"></a><span class='comment'>-- test whether an attribute name is a namesapce declaration name.</span>
<a name="line-436"></a><span class='comment'>-- If this is not the case True is the result, else</span>
<a name="line-437"></a><span class='comment'>-- the name must be a well formed namespace name:</span>
<a name="line-438"></a><span class='comment'>-- All namespace prefixes starting with \"xml\" are reserved for XML related definitions.</span>
<a name="line-439"></a><span class='comment'>-- predicate is used in filter 'valdateNamespaces'.</span>
<a name="line-440"></a>
<a name="line-441"></a><a name="isWellformedNSDecl"></a><span class='definition'>isWellformedNSDecl</span>              <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-442"></a><span class='definition'>isWellformedNSDecl</span> <span class='varid'>n</span>            <span class='keyglyph'>=</span> <span class='varid'>not</span> <span class='layout'>(</span><span class='varid'>isNameSpaceName</span> <span class='varid'>n</span><span class='layout'>)</span>
<a name="line-443"></a>                                  <span class='varop'>||</span>
<a name="line-444"></a>                                  <span class='varid'>isWellformedNameSpaceName</span> <span class='varid'>n</span>
<a name="line-445"></a>
<a name="line-446"></a><span class='comment'>-- |</span>
<a name="line-447"></a><span class='comment'>-- test for a namespace name to be well formed</span>
<a name="line-448"></a>
<a name="line-449"></a><a name="isWellformedNameSpaceName"></a><span class='definition'>isWellformedNameSpaceName</span>               <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-450"></a><span class='definition'>isWellformedNameSpaceName</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp</span><span class='layout'>)</span>       <span class='keyglyph'>=</span> <span class='varid'>lp</span> <span class='varop'>==</span> <span class='varid'>xmlnsXName</span>
<a name="line-451"></a><span class='definition'>isWellformedNameSpaceName</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='varid'>n</span><span class='layout'>)</span>     <span class='keyglyph'>=</span> <span class='varid'>px</span> <span class='varop'>==</span> <span class='varid'>xmlnsXName</span>
<a name="line-452"></a>                                          <span class='varop'>&amp;&amp;</span>
<a name="line-453"></a>                                          <span class='varid'>not</span> <span class='layout'>(</span><span class='varid'>null</span> <span class='varid'>lp'</span><span class='layout'>)</span>
<a name="line-454"></a>                                          <span class='varop'>&amp;&amp;</span>
<a name="line-455"></a>                                          <span class='varid'>not</span> <span class='layout'>(</span><span class='varid'>a_xml</span> <span class='varop'>`isPrefixOf`</span> <span class='varid'>lp'</span><span class='layout'>)</span>
<a name="line-456"></a>                                          <span class='keyword'>where</span>
<a name="line-457"></a>                                          <span class='varid'>lp'</span> <span class='keyglyph'>=</span> <span class='varid'>localPart</span> <span class='varid'>n</span>
<a name="line-458"></a><span class='definition'>isWellformedNameSpaceName</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>      <span class='keyglyph'>=</span> <span class='varid'>isWellformedNSDecl</span> <span class='varid'>n</span>
<a name="line-459"></a>
<a name="line-460"></a><span class='comment'>-- |</span>
<a name="line-461"></a><span class='comment'>-- test whether a name is a namespace declaration attribute name</span>
<a name="line-462"></a>
<a name="line-463"></a><a name="isNameSpaceName"></a><span class='definition'>isNameSpaceName</span>                 <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-464"></a><span class='definition'>isNameSpaceName</span> <span class='layout'>(</span><span class='conid'>LP</span> <span class='varid'>lp</span><span class='layout'>)</span>         <span class='keyglyph'>=</span> <span class='varid'>lp</span> <span class='varop'>==</span> <span class='varid'>xmlnsXName</span>
<a name="line-465"></a><span class='definition'>isNameSpaceName</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='keyword'>_</span><span class='layout'>)</span>       <span class='keyglyph'>=</span> <span class='varid'>px</span> <span class='varop'>==</span> <span class='varid'>xmlnsXName</span>
<a name="line-466"></a><span class='definition'>isNameSpaceName</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span>  <span class='varid'>n</span><span class='layout'>)</span>       <span class='keyglyph'>=</span> <span class='varid'>isNameSpaceName</span> <span class='varid'>n</span>
<a name="line-467"></a>
<a name="line-468"></a><span class='comment'>-- |</span>
<a name="line-469"></a><span class='comment'>-- </span>
<a name="line-470"></a><span class='comment'>-- predicate is used in filter 'valdateNamespaces'.</span>
<a name="line-471"></a>
<a name="line-472"></a><a name="isDeclaredNamespace"></a><span class='definition'>isDeclaredNamespace</span>             <span class='keyglyph'>::</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-473"></a><span class='definition'>isDeclaredNamespace</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='varid'>ns</span> <span class='varid'>n</span><span class='layout'>)</span>   <span class='keyglyph'>=</span> <span class='varid'>isNS</span> <span class='varid'>ns</span>        <span class='varid'>n</span>
<a name="line-474"></a><span class='definition'>isDeclaredNamespace</span>        <span class='varid'>n</span>    <span class='keyglyph'>=</span> <span class='varid'>isNS</span> <span class='varid'>nullXName</span> <span class='varid'>n</span>
<a name="line-475"></a>
<a name="line-476"></a><a name="isNS"></a><span class='definition'>isNS</span>                            <span class='keyglyph'>::</span> <span class='conid'>XName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>QName</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Bool</span>
<a name="line-477"></a><span class='definition'>isNS</span> <span class='keyword'>_</span>  <span class='layout'>(</span><span class='conid'>LP</span> <span class='keyword'>_</span><span class='layout'>)</span>                  <span class='keyglyph'>=</span> <span class='conid'>True</span>                          <span class='comment'>-- no namespace used</span>
<a name="line-478"></a><span class='definition'>isNS</span> <span class='varid'>ns</span> <span class='layout'>(</span><span class='conid'>PX</span> <span class='varid'>px</span> <span class='keyword'>_</span><span class='layout'>)</span>
<a name="line-479"></a>    <span class='keyglyph'>|</span> <span class='varid'>px</span> <span class='varop'>==</span> <span class='varid'>xmlnsXName</span>          <span class='keyglyph'>=</span> <span class='varid'>ns</span> <span class='varop'>==</span> <span class='varid'>xmlnsNamespaceXName</span>     <span class='comment'>-- "xmlns" has a predefined namespace uri</span>
<a name="line-480"></a>    <span class='keyglyph'>|</span> <span class='varid'>px</span> <span class='varop'>==</span> <span class='varid'>xmlXName</span>            <span class='keyglyph'>=</span> <span class='varid'>ns</span> <span class='varop'>==</span> <span class='varid'>xmlNamespaceXName</span>       <span class='comment'>-- "xml" has a predefiend namespace"</span>
<a name="line-481"></a>    <span class='keyglyph'>|</span> <span class='varid'>otherwise</span>                 <span class='keyglyph'>=</span> <span class='varid'>ns</span> <span class='varop'>/=</span> <span class='varid'>nullXName</span>               <span class='comment'>-- namespace values are not empty</span>
<a name="line-482"></a><span class='definition'>isNS</span> <span class='varid'>ns</span> <span class='layout'>(</span><span class='conid'>NS</span> <span class='keyword'>_</span> <span class='varid'>n</span><span class='layout'>)</span>                <span class='keyglyph'>=</span> <span class='varid'>isNS</span> <span class='varid'>ns</span> <span class='varid'>n</span>                     <span class='comment'>-- this does not occur, but warning is prevented</span>
<a name="line-483"></a>
<a name="line-484"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-485"></a>
<a name="line-486"></a><a name="toNsEnv"></a><span class='definition'>toNsEnv</span>                         <span class='keyglyph'>::</span> <span class='conid'>AssocList</span> <span class='conid'>String</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>NsEnv</span>
<a name="line-487"></a><span class='definition'>toNsEnv</span>                         <span class='keyglyph'>=</span> <span class='varid'>map</span> <span class='layout'>(</span><span class='varid'>newXName</span> <span class='varop'>***</span> <span class='varid'>newXName</span><span class='layout'>)</span>
<a name="line-488"></a>
<a name="line-489"></a><span class='comment'>-- -----------------------------------------------------------------------------</span>
<a name="line-490"></a>
<a name="line-491"></a><span class='comment'>-- the name cache, same implementation strategy as in Data.Atom,</span>
<a name="line-492"></a><span class='comment'>-- but conversion to and from ByteString prevented</span>
<a name="line-493"></a>
<a name="line-494"></a><a name="Atoms"></a><span class='keyword'>type</span> <span class='conid'>Atoms</span>      <span class='keyglyph'>=</span> <span class='conid'>M</span><span class='varop'>.</span><span class='conid'>Map</span> <span class='conid'>String</span> <span class='conid'>String</span>
<a name="line-495"></a>
<a name="line-496"></a><a name="Atom"></a><span class='keyword'>newtype</span> <span class='conid'>Atom</span>    <span class='keyglyph'>=</span> <span class='conid'>A</span> <span class='conid'>String</span>
<a name="line-497"></a>                  <span class='keyword'>deriving</span> <span class='layout'>(</span><span class='conid'>Eq</span><span class='layout'>,</span> <span class='conid'>Ord</span><span class='layout'>,</span> <span class='conid'>Typeable</span><span class='layout'>)</span>
<a name="line-498"></a>
<a name="line-499"></a><span class='comment'>-- ------------------------------------------------------------</span>
<a name="line-500"></a>
<a name="line-501"></a><span class='comment'>-- | the internal cache for the strings</span>
<a name="line-502"></a>
<a name="line-503"></a><a name="theAtoms"></a><span class='definition'>theAtoms</span>        <span class='keyglyph'>::</span> <span class='conid'>MVar</span> <span class='conid'>Atoms</span>
<a name="line-504"></a><span class='definition'>theAtoms</span>        <span class='keyglyph'>=</span> <span class='varid'>unsafePerformIO</span> <span class='layout'>(</span><span class='varid'>newMVar</span> <span class='conid'>M</span><span class='varop'>.</span><span class='varid'>empty</span><span class='layout'>)</span>
<a name="line-505"></a><span class='comment'>{-# NOINLINE theAtoms #-}</span>
<a name="line-506"></a>
<a name="line-507"></a><span class='comment'>-- | insert a bytestring into the atom cache</span>
<a name="line-508"></a>
<a name="line-509"></a><a name="insertAtom"></a><span class='definition'>insertAtom</span>      <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Atoms</span> <span class='keyglyph'>-&gt;</span> <span class='layout'>(</span><span class='conid'>Atoms</span><span class='layout'>,</span> <span class='conid'>Atom</span><span class='layout'>)</span>
<a name="line-510"></a><span class='definition'>insertAtom</span> <span class='varid'>s</span> <span class='varid'>m</span>  <span class='keyglyph'>=</span> <span class='varid'>maybe</span> <span class='layout'>(</span><span class='conid'>M</span><span class='varop'>.</span><span class='varid'>insert</span> <span class='comment'>{- (trace (show s) s) -}</span> <span class='varid'>s</span> <span class='varid'>s</span> <span class='varid'>m</span><span class='layout'>,</span> <span class='conid'>A</span> <span class='varid'>s</span> <span class='varop'>`demanding`</span> <span class='varid'>rnf</span> <span class='varid'>s</span><span class='layout'>)</span>
<a name="line-511"></a>                        <span class='layout'>(</span><span class='keyglyph'>\</span> <span class='varid'>s'</span> <span class='keyglyph'>-&gt;</span> <span class='layout'>(</span><span class='varid'>m</span><span class='layout'>,</span> <span class='conid'>A</span> <span class='varid'>s'</span><span class='layout'>)</span><span class='layout'>)</span>
<a name="line-512"></a>                  <span class='varop'>.</span>
<a name="line-513"></a>                  <span class='conid'>M</span><span class='varop'>.</span><span class='varid'>lookup</span> <span class='varid'>s</span> <span class='varop'>$</span> <span class='varid'>m</span>
<a name="line-514"></a>
<a name="line-515"></a><span class='comment'>-- | creation of an @Atom@ from a @String@</span>
<a name="line-516"></a>
<a name="line-517"></a><a name="newAtom"></a><span class='definition'>newAtom</span>         <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>Atom</span>
<a name="line-518"></a><span class='definition'>newAtom</span>         <span class='keyglyph'>=</span> <span class='varid'>unsafePerformIO</span> <span class='varop'>.</span> <span class='varid'>newAtom'</span>
<a name="line-519"></a><span class='comment'>{-# NOINLINE newAtom #-}</span>
<a name="line-520"></a>
<a name="line-521"></a><a name="newAtom'"></a><span class='comment'>-- | The internal operation running in the IO monad</span>
<a name="line-522"></a><span class='definition'>newAtom'</span>        <span class='keyglyph'>::</span> <span class='conid'>String</span> <span class='keyglyph'>-&gt;</span> <span class='conid'>IO</span> <span class='conid'>Atom</span>
<a name="line-523"></a><span class='definition'>newAtom'</span> <span class='varid'>s</span>      <span class='keyglyph'>=</span> <span class='keyword'>do</span>
<a name="line-524"></a>                  <span class='varid'>m</span> <span class='keyglyph'>&lt;-</span> <span class='varid'>takeMVar</span> <span class='varid'>theAtoms</span>
<a name="line-525"></a>                  <span class='keyword'>let</span> <span class='layout'>(</span><span class='varid'>m'</span><span class='layout'>,</span> <span class='varid'>a</span><span class='layout'>)</span> <span class='keyglyph'>=</span> <span class='varid'>insertAtom</span> <span class='varid'>s</span> <span class='varid'>m</span>
<a name="line-526"></a>                  <span class='varid'>putMVar</span> <span class='varid'>theAtoms</span> <span class='varid'>m'</span>
<a name="line-527"></a>                  <span class='varid'>return</span> <span class='varid'>a</span>
<a name="line-528"></a>
<a name="line-529"></a><span class='keyword'>instance</span> <span class='conid'>Read</span> <span class='conid'>Atom</span> <span class='keyword'>where</span>
<a name="line-530"></a>    <span class='varid'>readsPrec</span> <span class='varid'>p</span> <span class='varid'>str</span> <span class='keyglyph'>=</span> <span class='keyglyph'>[</span> <span class='layout'>(</span><span class='varid'>newAtom</span> <span class='varid'>x</span><span class='layout'>,</span> <span class='varid'>y</span><span class='layout'>)</span> <span class='keyglyph'>|</span> <span class='layout'>(</span><span class='varid'>x</span><span class='layout'>,</span> <span class='varid'>y</span><span class='layout'>)</span> <span class='keyglyph'>&lt;-</span> <span class='varid'>readsPrec</span> <span class='varid'>p</span> <span class='varid'>str</span> <span class='keyglyph'>]</span>
<a name="line-531"></a>
<a name="line-532"></a><span class='keyword'>instance</span> <span class='conid'>Show</span> <span class='conid'>Atom</span> <span class='keyword'>where</span>
<a name="line-533"></a>    <span class='varid'>show</span> <span class='layout'>(</span><span class='conid'>A</span> <span class='varid'>s</span><span class='layout'>)</span>  <span class='keyglyph'>=</span> <span class='varid'>s</span>
<a name="line-534"></a>
<a name="line-535"></a><span class='keyword'>instance</span> <span class='conid'>NFData</span> <span class='conid'>Atom</span> <span class='keyword'>where</span>
<a name="line-536"></a>
<a name="line-537"></a><span class='comment'>-----------------------------------------------------------------------------</span>
</pre></body>
</html>