Sophie

Sophie

distrib > Mandriva > 2007.1 > i586 > by-pkgid > 09cecd41fd5510f1b4c6358078b3faaf > files > 188

haskell-HXT-7.1-2mdv2007.1.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--Rendered using the Haskell Html Library v0.2-->
<HTML
><HEAD
><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"
><TITLE
>Text.XML.HXT.DOM.XmlState</TITLE
><LINK HREF="haddock.css" REL="stylesheet" TYPE="text/css"
><SCRIPT SRC="haddock.js" TYPE="text/javascript"
></SCRIPT
></HEAD
><BODY
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="topbar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><IMG SRC="haskell_icon.gif" WIDTH="16" HEIGHT="16" ALT=" "
></TD
><TD CLASS="title"
>hxt-7.1: </TD
><TD CLASS="topbut"
><A HREF="index.html"
>Contents</A
></TD
><TD CLASS="topbut"
><A HREF="doc-index.html"
>Index</A
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="modulebar"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD
><FONT SIZE="6"
>Text.XML.HXT.DOM.XmlState</FONT
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Description</TD
></TR
><TR
><TD CLASS="doc"
><P
>This module provides a Monad for an internal state and IO commands.
 The state consists of two parts, the user state and the system state
 user state ist a type parameter, the system state is a list
 name-value pair. If the user state is not needed, the type parameter
 can be instantiated with <TT
>()</TT
>.
</P
><P
>Furthermore there are types for Xml filter working on this monad
 and functions for manipulating the state components
 and for lifting i/o commands and XmlFilter to monad filters.
</P
><P
>Error reporting functions are also located in this module.
</P
><P
>Version : $Id: XmlState.hs,v 1.3 2005<EM
>05</EM
>27 13:15:23 hxml Exp $
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Synopsis</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
> <A HREF="#t%3ASysState"
>SysState</A
>  = <A HREF="#v%3ASysState"
>SysState</A
> {<TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="recfield"
><A HREF="#v%3AsysStateAttrs"
>sysStateAttrs</A
> :: !<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysStateAttrs"
>SysStateAttrs</A
></TD
></TR
><TR
><TD CLASS="recfield"
><A HREF="#v%3AsysStateErrorHandler"
>sysStateErrorHandler</A
> :: !(<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> ())</TD
></TR
></TABLE
>}</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A HREF="#t%3ASysStateAttrs"
>SysStateAttrs</A
> = <A HREF="Data-AssocList.html#t%3AAssocList"
>AssocList</A
> String <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
> <A HREF="#t%3AXmlState"
>XmlState</A
> state = <A HREF="#v%3AXmlState"
>XmlState</A
> {<TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="recfield"
><A HREF="#v%3AsysState"
>sysState</A
> :: !<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="recfield"
><A HREF="#v%3AuserState"
>userState</A
> :: !state</TD
></TR
></TABLE
>}</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A HREF="#t%3AXState"
>XState</A
> state res = <A HREF="Control-Monad-MonadStateIO.html#t%3AStateIO"
>StateIO</A
> (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlState"
>XmlState</A
> state) res</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A HREF="#t%3AXmlStateFilter"
>XmlStateFilter</A
> state = <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTree"
>XmlTree</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AchangeState"
>changeState</A
> :: (state -&gt; state) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetState"
>setState</A
> :: state -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetState"
>getState</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AchangeSysState"
>changeSysState</A
> :: (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
>) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetSysState"
>setSysState</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetSysState"
>getSysState</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AinitialSysState"
>initialSysState</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AchangeSysStateAttrs"
>changeSysStateAttrs</A
> :: (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysStateAttrs"
>SysStateAttrs</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysStateAttrs"
>SysStateAttrs</A
>) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetSysErrorHandler"
>setSysErrorHandler</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> () -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetSysErrorHandler"
>getSysErrorHandler</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> ())</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetSysParamTree"
>setSysParamTree</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetSysParam"
>setSysParam</A
> :: String -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetSysParamInt"
>setSysParamInt</A
> :: String -&gt; Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetSystemParams"
>setSystemParams</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetSysParamTree"
>getSysParamTree</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetSysParam"
>getSysParam</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state String</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetSysParamWithDefault"
>getSysParamWithDefault</A
> :: String -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state String</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetSysParamInt"
>getSysParamInt</A
> :: String -&gt; Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state Int</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Arun0"
>run0</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlState"
>XmlState</A
> state -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state res -&gt; IO (res, <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlState"
>XmlState</A
> state)</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Arun"
>run</A
> :: state -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state res -&gt; IO res</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Arun%27"
>run'</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> () res -&gt; IO res</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Achain%27"
>chain'</A
> :: state1 -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state1 res -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state0 (res, state1)</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Achain"
>chain</A
> :: state1 -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state1 res -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state0 res</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AliftF"
>liftF</A
> :: <A HREF="Text-XML-HXT-DOM-XmlTreeTypes.html#t%3AXmlFilter"
>XmlFilter</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Aio"
>io</A
> :: IO a -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state a</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetTraceLevel"
>setTraceLevel</A
> :: Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetTraceLevel"
>getTraceLevel</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state Int</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AtraceCmd"
>traceCmd</A
> :: Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state a -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3Atrace"
>trace</A
> :: Int -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AtraceState"
>traceState</A
> :: Int -&gt; (state -&gt; String) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AclearStatus"
>clearStatus</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AissueError"
>issueError</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AerrorMsgHandler"
>errorMsgHandler</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetErrorMsgLevel"
>setErrorMsgLevel</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AerrorMsgToStderr"
>errorMsgToStderr</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AerrorMsgLogging"
>errorMsgLogging</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AerrorMsgLoggingAndToStderr"
>errorMsgLoggingAndToStderr</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AgetErrorMsg"
>getErrorMsg</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AerrClass"
>errClass</A
> :: Int -&gt; String</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AissueWarn"
>issueWarn</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AissueErr"
>issueErr</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AissueFatal"
>issueFatal</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AaddFatal"
>addFatal</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AcheckStatus"
>checkStatus</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AsetStatus"
>setStatus</A
> :: Int -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlTreeTypes.html#t%3AXmlFilter"
>XmlFilter</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AstatusOk"
>statusOk</A
> :: <A HREF="Text-XML-HXT-DOM-XmlTreeTypes.html#t%3AXmlFilter"
>XmlFilter</A
></TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AcheckResult"
>checkResult</A
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s8"
></TD
></TR
><TR
><TD CLASS="decl"
><A HREF="#v%3AprocessAttrM"
>processAttrM</A
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> a -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> a</TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="section1"
>Documentation</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
> <A NAME="t%3ASysState"
></A
><B
>SysState</B
> </TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="ndoc"
>The internal system state consists of a list of name-value pairs
 of type <TT
>(String, XmlTrees)</TT
>, so arbitrary lists of trees can be stored.
 For options, often only strings are used as values, so a set of access
 functions with string values is available
 The error handling method can be controlled by an error handler filter,
 the default filter issues the errors on stderr
</TD
></TR
><TR
><TD CLASS="section4"
>Constructors</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="5" CELLPADDING="0"
><TR
><TD CLASS="arg"
><A NAME="v%3ASysState"
></A
><B
>SysState</B
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="body" COLSPAN="2"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="arg"
><A NAME="v%3AsysStateAttrs"
></A
><B
>sysStateAttrs</B
> :: !<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysStateAttrs"
>SysStateAttrs</A
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
><A NAME="v%3AsysStateErrorHandler"
></A
><B
>sysStateErrorHandler</B
> :: !(<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> ())</TD
><TD CLASS="rdoc"
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A NAME="t%3ASysStateAttrs"
></A
><B
>SysStateAttrs</B
> = <A HREF="Data-AssocList.html#t%3AAssocList"
>AssocList</A
> String <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>data</SPAN
> <A NAME="t%3AXmlState"
></A
><B
>XmlState</B
> state</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="0" CELLPADDING="0"
><TR
><TD CLASS="ndoc"
>The State has a system and a user part
 the user state is a type parameter
</TD
></TR
><TR
><TD CLASS="section4"
>Constructors</TD
></TR
><TR
><TD CLASS="body"
><TABLE CLASS="vanilla" CELLSPACING="5" CELLPADDING="0"
><TR
><TD CLASS="arg"
><A NAME="v%3AXmlState"
></A
><B
>XmlState</B
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="body" COLSPAN="2"
><TABLE CLASS="vanilla" CELLSPACING="1" CELLPADDING="0"
><TR
><TD CLASS="arg"
><A NAME="v%3AsysState"
></A
><B
>sysState</B
> :: !<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
><TD CLASS="rdoc"
></TD
></TR
><TR
><TD CLASS="arg"
><A NAME="v%3AuserState"
></A
><B
>userState</B
> :: !state</TD
><TD CLASS="rdoc"
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
></TABLE
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A NAME="t%3AXState"
></A
><B
>XState</B
> state res = <A HREF="Control-Monad-MonadStateIO.html#t%3AStateIO"
>StateIO</A
> (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlState"
>XmlState</A
> state) res</TD
></TR
><TR
><TD CLASS="doc"
>The monad type for commands. It is an instance of <A HREF="StateIO.html"
>StateIO</A
> from the
 general module <A HREF="Control-Monad-MonadStateIO.html"
>Control.Monad.MonadStateIO</A
>.
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><SPAN CLASS="keyword"
>type</SPAN
> <A NAME="t%3AXmlStateFilter"
></A
><B
>XmlStateFilter</B
> state = <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTree"
>XmlTree</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
></TD
></TR
><TR
><TD CLASS="doc"
>The <A HREF="XmlFilter.html"
>XmlFilter</A
> type for filters working on a state
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AchangeState"
></A
><B
>changeState</B
> :: (state -&gt; state) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state state</TD
></TR
><TR
><TD CLASS="doc"
><P
>change the user state
</P
><UL
><LI
> 1.parameter fct :  the user state change function
</LI
><LI
> returns : the new state
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetState"
></A
><B
>setState</B
> :: state -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state state</TD
></TR
><TR
><TD CLASS="doc"
><P
>set the user state.
</P
><UL
><LI
> 1.parameter s :  the new state
</LI
><LI
> returns : the new state
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetState"
></A
><B
>getState</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state state</TD
></TR
><TR
><TD CLASS="doc"
><P
>read the user state
</P
><UL
><LI
> returns : the current state
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AchangeSysState"
></A
><B
>changeSysState</B
> :: (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
>) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="doc"
><P
>change the system part of the state.
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AchangeState"
>changeState</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetSysState"
></A
><B
>setSysState</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="doc"
><P
>set the system part of the state.
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AsetState"
>setState</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetSysState"
></A
><B
>getSysState</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="doc"
><P
>read the system part of the state.
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AgetState"
>getState</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AinitialSysState"
></A
><B
>initialSysState</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="doc"
><P
>the initial system state
</P
><P
>an empty list of attribute value pairs
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AchangeSysStateAttrs"
></A
><B
>changeSysStateAttrs</B
> :: (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysStateAttrs"
>SysStateAttrs</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysStateAttrs"
>SysStateAttrs</A
>) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3ASysState"
>SysState</A
></TD
></TR
><TR
><TD CLASS="doc"
>change the attributes in the system state
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetSysErrorHandler"
></A
><B
>setSysErrorHandler</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> () -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
>set the error message handler
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetSysErrorHandler"
></A
><B
>getSysErrorHandler</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state (<A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> ())</TD
></TR
><TR
><TD CLASS="doc"
>get the error handler
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetSysParamTree"
></A
><B
>setSysParamTree</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>set or change a single system parameter.
</P
><UL
><LI
> 1.parameter name :  the name of the parameter
</LI
><LI
> 2.parameter value :  the list of associated trees
</LI
><LI
> returns : nothing
</LI
></UL
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AsetSysParam"
>setSysParam</A
></TT
>, <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AsetSysParamInt"
>setSysParamInt</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetSysParam"
></A
><B
>setSysParam</B
> :: String -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>set or change a single system parameter of type string.
</P
><UL
><LI
> 1.parameter name :  the name of the parameter
</LI
><LI
> 2.parameter value :  the (new) string value
</LI
><LI
> returns : nothing
</LI
></UL
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AsetSysParamTree"
>setSysParamTree</A
></TT
>, setSysParamInt
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetSysParamInt"
></A
><B
>setSysParamInt</B
> :: String -&gt; Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>set or change a single integer type system parameter
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AsetSysParam"
>setSysParam</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetSystemParams"
></A
><B
>setSystemParams</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>add (or change) all attributes of the document root to the system state
     - returns : this
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetSysParamTree"
></A
><B
>getSysParamTree</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state <A HREF="Text-XML-HXT-DOM-TypeDefs.html#t%3AXmlTrees"
>XmlTrees</A
></TD
></TR
><TR
><TD CLASS="doc"
><P
>read a system parameter
</P
><UL
><LI
> 1.parameter name :  the name of the parameter
</LI
><LI
> returns : the list of tres associated with the key, or the empty list for unknown parameters
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetSysParam"
></A
><B
>getSysParam</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state String</TD
></TR
><TR
><TD CLASS="doc"
><P
>read a system string parameter
</P
><UL
><LI
> 1.parameter name :  the name of the parameter
</LI
><LI
> returns : the value, or the empty string for unknown parameters
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetSysParamWithDefault"
></A
><B
>getSysParamWithDefault</B
> :: String -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state String</TD
></TR
><TR
><TD CLASS="doc"
><P
>read a system parameter or return a default value
</P
><UL
><LI
> 1.parameter name :  the name of the parameter
</LI
><LI
> 2.parameter default :  the default value
</LI
><LI
> returns : the value if found, else the default
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetSysParamInt"
></A
><B
>getSysParamInt</B
> :: String -&gt; Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state Int</TD
></TR
><TR
><TD CLASS="doc"
><P
>read an integer system parameter
</P
><UL
><LI
> 1.parameter name : 
</LI
><LI
> 2.parameter default : 
</LI
></UL
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AgetSysParamWithDefault"
>getSysParamWithDefault</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Arun0"
></A
><B
>run0</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlState"
>XmlState</A
> state -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state res -&gt; IO (res, <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlState"
>XmlState</A
> state)</TD
></TR
><TR
><TD CLASS="doc"
><P
>exec a XState command with initial state.
</P
><UL
><LI
> 1.parameter initalState :  the inital user state
</LI
><LI
> 2.parameter cmd :  the command
</LI
><LI
> returns : the i/o command with result and user state
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Arun"
></A
><B
>run</B
> :: state -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state res -&gt; IO res</TD
></TR
><TR
><TD CLASS="doc"
>exec a XState command with initial user state.
 ignore final user state.
 like run0, but ignore the resulting user state
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Arun%27"
></A
><B
>run'</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> () res -&gt; IO res</TD
></TR
><TR
><TD CLASS="doc"
>exec a XState command in th IO monad.
 like run with the empty state ().
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Achain%27"
></A
><B
>chain'</B
> :: state1 -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state1 res -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state0 (res, state1)</TD
></TR
><TR
><TD CLASS="doc"
><P
>run a command in a new user state.
 chain the system state part,
 init new system state with the current one, run the command and
 update the old system state with the resulting new system state
</P
><UL
><LI
> 1.parameter initialUserState :  the initial user state
</LI
><LI
> 2.parameter cmd :  the command
</LI
><LI
> returns : the result of executing cmd and the final state
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Achain"
></A
><B
>chain</B
> :: state1 -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state1 res -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state0 res</TD
></TR
><TR
><TD CLASS="doc"
><P
>like chain' but forget the final user state
</P
><UL
><LI
> 1.parameter initialUserState :  the initial user state
</LI
><LI
> 2.parameter cmd :  the command
</LI
><LI
> returns : only the result of executing cmd
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AliftF"
></A
><B
>liftF</B
> :: <A HREF="Text-XML-HXT-DOM-XmlTreeTypes.html#t%3AXmlFilter"
>XmlFilter</A
> -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
><P
>lift a XmlFilter to a XmlStateFilter filter
 issue all error nodes as error messages
 and remove the error nodes from the result
</P
><UL
><LI
> 1.parameter f :  the filter
</LI
><LI
> returns : the filter running in the state monad
</LI
></UL
><P
>all errors are filtered from the result and issued on stderr
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Aio"
></A
><B
>io</B
> :: IO a -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state a</TD
></TR
><TR
><TD CLASS="doc"
><P
>lift an I/O command
</P
><UL
><LI
> 1.parameter cmd :  the i/o command
</LI
><LI
> returns : the i/o command lifted to the XML state monad
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetTraceLevel"
></A
><B
>setTraceLevel</B
> :: Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>set the trace level.
</P
><P
>convention:
</P
><P
>0: no trace output (default)
</P
><P
>1: trace important computation steps, e.g. accessing a document
</P
><P
>2: trace small computation steps
</P
><P
>3: output an intermediate result XmlTree in XML source format
</P
><P
>4: output an intermediate result XmlTree in tree representation
</P
><UL
><LI
> 1.parameter level :  the trace level
</LI
><LI
> returns : nothing
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetTraceLevel"
></A
><B
>getTraceLevel</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state Int</TD
></TR
><TR
><TD CLASS="doc"
><P
>get the current trace level.
</P
><UL
><LI
> returns : the current trace level
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AtraceCmd"
></A
><B
>traceCmd</B
> :: Int -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state a -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>trace output for arbitray commands.
</P
><UL
><LI
> 1.parameter level :  the trace level,
			  for which the command will be execuded
			  if level &lt;= current trace level
</LI
><LI
> 2.parameter cmd :  the command to be executed
</LI
><LI
> returns : nothing
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3Atrace"
></A
><B
>trace</B
> :: Int -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>trace output function for simple text.
</P
><UL
><LI
> 1.parameter level :  like in traceCmd
</LI
><LI
> 2.parameter str :  the test
</LI
><LI
> returns : nothing
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AtraceState"
></A
><B
>traceState</B
> :: Int -&gt; (state -&gt; String) -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXState"
>XState</A
> state ()</TD
></TR
><TR
><TD CLASS="doc"
><P
>trace output of the user part of the program state.
</P
><UL
><LI
> 1.parameter level :  like in traceCmd
</LI
><LI
> 2.parameter showFct :  the toString function
</LI
><LI
> returns : nothing
</LI
></UL
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AclearStatus"
></A
><B
>clearStatus</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>filter to reset the state attribute <TT
><A HREF="Text-XML-HXT-DOM-XmlKeywords.html#v%3Aa_status"
>a_status</A
></TT
>
    - returns : this
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AissueError"
></A
><B
>issueError</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
><P
>report an error message.
</P
><UL
><LI
> returns : if the input tree n represents an error, <TT
>res = []</TT
>
		  and the error is processed by the errror handler filter (default: error is issued on stderr)
		  else <TT
>res = [n]</TT
>
</LI
></UL
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AissueErr"
>issueErr</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AerrorMsgHandler"
></A
><B
>errorMsgHandler</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetErrorMsgLevel"
></A
><B
>setErrorMsgLevel</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>set the error level in system state
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AerrorMsgToStderr"
></A
><B
>errorMsgToStderr</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>default error handler for writing errors to stderr
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AerrorMsgLogging"
></A
><B
>errorMsgLogging</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>error message handler for collecting all error messages
 all messages are stored under attribute <TT
><A HREF="Text-XML-HXT-DOM-XmlKeywords.html#v%3Aa_error_log"
>a_error_log</A
></TT
>
 they can be read with <TT
>getSysParamTree a_error_log</TT
> or by
 applying the filter <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AgetErrorMsg"
>getErrorMsg</A
></TT
> to the root node
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AerrorMsgLoggingAndToStderr"
></A
><B
>errorMsgLoggingAndToStderr</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AgetErrorMsg"
></A
><B
>getErrorMsg</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
><P
>the filter for reading all collected error mesages
</P
><P
>result is the list of error messages, the input tree is ignored
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AerrClass"
></A
><B
>errClass</B
> :: Int -&gt; String</TD
></TR
><TR
><TD CLASS="doc"
>error level translation
 <TT
><A HREF="Text-XML-HXT-DOM-TypeDefs.html#v%3Ac_warn"
>c_warn</A
></TT
> (1) : warning,
 <TT
><A HREF="Text-XML-HXT-DOM-TypeDefs.html#v%3Ac_err"
>c_err</A
></TT
> (2): error (e.g. parse error, validation error, ...),
 <TT
><A HREF="Text-XML-HXT-DOM-TypeDefs.html#v%3Ac_fatal"
>c_fatal</A
></TT
> (3) : fatal error (document access error, internal error, ...)
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AissueWarn"
></A
><B
>issueWarn</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
><P
>short cut for issuing a warning
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AissueError"
>issueError</A
></TT
>, <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AissueErr"
>issueErr</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AissueErr"
></A
><B
>issueErr</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
><P
>short cut for issuing an error
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AissueError"
>issueError</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AissueFatal"
></A
><B
>issueFatal</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
><P
>short cut for issuing a fatal error
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AissueError"
>issueError</A
></TT
>, <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AissueErr"
>issueErr</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AaddFatal"
></A
><B
>addFatal</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AcheckStatus"
></A
><B
>checkStatus</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>checks the value of the attribute <TT
><A HREF="Text-XML-HXT-DOM-XmlKeywords.html#v%3Aa_status"
>a_status</A
></TT
> in a document root.
 if it contains a value greater or equal to <TT
><A HREF="Text-XML-HXT-DOM-TypeDefs.html#v%3Ac_err"
>c_err</A
></TT
>, an error with error message
 stored in attribute <TT
><A HREF="Text-XML-HXT-DOM-XmlKeywords.html#v%3Aa_module"
>a_module</A
></TT
> is issued and the filter acts as the <TT
><A HREF="Data-Tree-NTree-Filter.html#v%3AnoneM"
>noneM</A
></TT
> filter
 else its the <TT
><A HREF="Data-Tree-NTree-Filter.html#v%3AthisM"
>thisM</A
></TT
> filter
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AsetStatus"
></A
><B
>setStatus</B
> :: Int -&gt; String -&gt; <A HREF="Text-XML-HXT-DOM-XmlTreeTypes.html#t%3AXmlFilter"
>XmlFilter</A
></TD
></TR
><TR
><TD CLASS="doc"
>add the error level and the module where the error occured
 to the attributes of a document root node and remove the children when level is greater or equal to <TT
><A HREF="Text-XML-HXT-DOM-TypeDefs.html#v%3Ac_err"
>c_err</A
></TT
>
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AstatusOk"
></A
><B
>statusOk</B
> :: <A HREF="Text-XML-HXT-DOM-XmlTreeTypes.html#t%3AXmlFilter"
>XmlFilter</A
></TD
></TR
><TR
><TD CLASS="doc"
>check whether tree is a document root and the status attribute has a value less than <TT
><A HREF="Text-XML-HXT-DOM-TypeDefs.html#v%3Ac_err"
>c_err</A
></TT
>
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AcheckResult"
></A
><B
>checkResult</B
> :: String -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> state</TD
></TR
><TR
><TD CLASS="doc"
>check whether the error level attribute in the system state
 is set to error, in this case the children of the document root are
 removed and error info is added as attributes with <TT
><A HREF="Text-XML-HXT-DOM-XmlState.html#v%3AsetStatus"
>setStatus</A
></TT
>
 else nothing is changed
</TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="decl"
><A NAME="v%3AprocessAttrM"
></A
><B
>processAttrM</B
> :: <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> a -&gt; <A HREF="Text-XML-HXT-DOM-XmlState.html#t%3AXmlStateFilter"
>XmlStateFilter</A
> a</TD
></TR
><TR
><TD CLASS="doc"
><P
>monadic filter for processing the attribute list of a tag.
 for other trees this filter acts like <TT
><A HREF="Data-Tree-NTree-Filter.html#v%3AnoneM"
>noneM</A
></TT
>
</P
><P
>see also : <TT
><A HREF="Text-XML-HXT-DOM-XmlTreeFilter.html#v%3AprocessAttr"
>processAttr</A
></TT
>, <TT
><A HREF="Text-XML-HXT-DOM-XmlTreeFilter.html#v%3AprocessAttrl"
>processAttrl</A
></TT
>
</P
></TD
></TR
><TR
><TD CLASS="s15"
></TD
></TR
><TR
><TD CLASS="botbar"
>Produced by <A HREF="http://www.haskell.org/haddock/"
>Haddock</A
> version 0.8</TD
></TR
></TABLE
></BODY
></HTML
>

Perl :: Catalyst :: PostgreSQL :: RPM Valid HTML 4.01 Transitional