HaXml-1.25.8: Utilities for manipulating XML documents

Text.XML.HaXml.Namespaces

Synopsis

# Documentation

The null Namespace (no prefix, no URI).

Every Name can be split into a Namespace and local Name. The Namespace might of course be missing.

Return the (possibly absent) Namespace component of a Name.

Return the local component of a Name, without its Namespace.

Return the printable string for a Name, i.e. attaching a prefix for its namespace (if it has one).

qualify splits a Name of the form "pr:nm" into the prefix "pr" and local name "nm", and looks up the prefix in the given environment to determine its Namespace. There may also be a default namespace (the first argument) for unqualified names. In the absence of a default Namespace, a Name that does not have a prefix remains unqualified. A prefix that is not known in the environment becomes a fresh namespace with null URI. A Name that is already qualified is passed unchanged, unless its URI was null, in which case we check afresh for that prefix in the environment.

deQualify has the same signature as qualify, but ignores the arguments for default namespace and environment, and simply removes any pre-existing qualification.

qualifyExceptLocal converts names to qualified names, except where an existing qualification matches the default namespace, in which case the qualification is removed. (This is useful when translating QNames to Haskell, because Haskell qualified names cannot use the current module name.)

The initial Namespace environment. It always has bindings for the prefixes xml and xmlns.

Add a fresh Namespace into the Namespace environment. It is not permitted to rebind the prefixes xml or xmlns, but that is not checked here.

resolveAllNames in a document, causes every name to be properly qualified with its namespace. There is a default namespace for any name that was originally unqualified. This is likely only useful when dealing with parsed document, less useful when generating a document from scratch.