hxt-filter-8.4.0: A collection of tools for processing XML with Haskell (Filter variant).

Portabilityportable
Stabilitystable
MaintainerUwe Schmidt (uwe@fh-wedel.de)

Text.XML.HXT.DOM.XmlTreeFunctions

Description

Basic XmlTree functions

Synopsis

Documentation

mkXTagTree :: String -> XmlTrees -> XmlTrees -> XmlTreeSource

Create a tree with a tag node.

  • 1.parameter n : the name of the tag
  • 2.parameter al : the tag attribte list
  • 3.parameter cs : the list of children
  • returns : the new tree

mkQTagTree :: QName -> XmlTrees -> XmlTrees -> XmlTreeSource

Version with qualified name of mkXTagTree

mkXNsTagTree :: String -> String -> XmlTrees -> XmlTrees -> XmlTreeSource

create a tree with a namespace aware tag node.

  • 1.parameter n : the prefix:localpart of the tag
  • 2.parameter ns: the namespace uri
  • 3.parameter al : the tag attribte list
  • 4.parameter cs : the list of children
  • returns : the new tree

see also: mkXTagTree

newRoot :: XmlTrees -> XmlTreeSource

creates a new document tree with empty contents.

  • 1.parameter al : the attribute list for the root node

returns a single node tree with tag name "/" indicating a root and with empty list of children

see also : emptyRoot

emptyRoot :: XmlTreeSource

the empty document tree

see also : newRoot

newDocument :: String -> XmlTreeSource

create a new empty document with source name as parameter

newDocument' :: Attributes -> XmlTreeSource

create a new empty document with a list of attributes for source location and options

see also : newDocument

mkRootTree :: XmlTrees -> XmlTrees -> XmlTreeSource

create a document root tree.

  • 1.parameter al : the attribute list for the root. This list must contain at least an attribute "source" that contains the URI of the document to be processed
  • 2.parameter cs : the list for the document content
  • returns : the document root

mkXTextTree :: String -> XmlTreeSource

create a leaf for a text element.

  • 1.parameter txt : the text
  • returns : the tree with the single node containing the text

mkXCharRefTree :: Int -> XmlTreeSource

create a leaf for a char reference.

  • 1.parameter i : the integer representing the Unicode char
  • returns : the tree with the single node containing the char reference

mkXEntityRefTree :: String -> XmlTreeSource

create a leaf for an entity reference.

  • 1.parameter n : the name of the entity reference
  • returns : the tree with the single node containing the entity reference

mkXCmtTree :: String -> XmlTreeSource

create a leaf for a comment,

  • 1.parameter c : the comment text
  • returns : the tree with the single node containing the comment

mkXDTDTree :: DTDElem -> Attributes -> XmlTrees -> XmlTreeSource

create a tree for a part of a DTD

  • 1.parameter d : the type of the DTD part
  • 2.parameter al : the attribute list for the DTD part
  • 3.parameter ds : the possibly empty list of components for the DTD part
  • returns : the tree with the composed DTD part

mkXAttrTree :: String -> XmlTrees -> XmlTreeSource

create an attribute tree as part of a tag attribute list of tag nodes

  • 1.parameter al : the attribute name
  • 2.parameter av : the attribute value as tree list, usually containing a single text node

mkQAttrTree :: QName -> XmlTrees -> XmlTreeSource

Qualified version of mkXAttrTree

mkXNsAttrTree :: String -> String -> XmlTrees -> XmlTreeSource

create an attribute tree with a namespace

  • 1.parameter al : the attribute name
  • 2.parameter ns : namespace uri
  • 3.parameter av : the attribute value as tree list, usually containing a single text node

see also: mkXAttrTree, mkXNsTagTree

mkXPERefTree :: String -> XmlTreeSource

create a parameter entity reference DTD part.

  • 1.parameter ref : the name of the reference
  • returns : the DTD part for a PERef

mkXPiTree :: String -> String -> XmlTreeSource

create a processing instruction tree.

  • 1.parameter n : the name of the PI
  • 2.parameter str : the content of a PI
  • returns : the processing instruction tree with a single attribute "value" with the str parameter as attribute value, with valueOf a_value applied to the result tree the content of the PI can be selected

mkXmlDeclTree :: XmlTrees -> XmlTreeSource

create xml declaration

mkXCdataTree :: String -> XmlTreeSource

create a CDATA section tree.

  • 1.parameter s : the content of the CDATA section
  • returns : the tree for the CDATA section

mkXErrorTree :: Int -> String -> XmlTrees -> XmlTreeSource

create an error tree.

  • 1.parameter l : the level of the error (warning, error fatal)
  • 2.parameter msg : the error message
  • 3.parameter cs : the context, where the error was detected

xmlTreesToString :: XmlTrees -> StringSource

old name for xshow (deprecated)

xmlTreesToText :: XmlSFilterSource

conversion of a filter result into a text node

see also : xshow

nameOf :: XmlTree -> StringSource

select the name of a node. For tags, attributes and pi's the name string is returned, else the empty string.

localPartOf :: XmlTree -> StringSource

select the local part of a name of a node. For tags, attributes the name string is returned, for pi's the whole name, else the empty string.

namespaceOf :: XmlTree -> StringSource

select the namespace URI of a tag or an attribute tree, else the empty string is returned see also : nameOf

prefixOf :: XmlTree -> StringSource

select the namespace prefix of a tag or an attribute tree, else the empty string is returned see also : nameOf, localPartOf

universalNameOf :: XmlTree -> StringSource

select the universal name (namespace uri ++ localPart) of a tag or an attribute tree, else the empty string is returned see also : nameOf, namespaceOf

attrlOfDTD :: XmlTree -> AttributesSource

select the attributes of a dtd tree

valueOfDTD :: String -> XmlTree -> StringSource

select a special attribute of a DTD part

ofDTDequals :: String -> String -> XmlTree -> BoolSource

test an attribute of a DTD part