hxt-8.5.4: A collection of tools for processing XML with Haskell.

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

Text.XML.HXT.Arrow.DocumentInput

Description

Version : $Id$

State arrows for document input

Synopsis

Documentation

getXmlContents :: IOStateArrow s XmlTree XmlTreeSource

Read the content of a document.

This routine is usually called from Text.XML.HXT.Arrow.ProcessDocument.getDocumentContents.

The input must be a root node (constructed with root), usually without children. The attribute list contains all input parameters, e.g. URI or source file name, encoding preferences, ... If the source name is empty, the input is read from standard input.

The source is transformed into an absolute URI. If the source is a relative URI, or a file name, it is expanded into an absolut URI with respect to the current base URI. The default base URI is of protocol "file" and points to the current working directory.

The currently supported protocols are "http", "file", "stdin" and "string".

The latter two are internal protocols. An uri of the form "stdin:" stands for the content of the standard input stream.

"string:some text" means, that "some text" is taken as input. This internal protocol is used for reading from normal String values.