The OMXMLWRITE library can be used to convert a markup event stream to a well-formed XML instance. The library exports two functions, xml.writer and xml.written. Each function performs the same task through a different interface; which one is better to use depends on the context.

The following example program parses well-formed XML input and uses the OMXMLWRITE library to write it out as XML again.

  import "omxmlwrite.xmd" prefixed by xml.
  
  process
     do xml-parse scan #main-input
        output xml.written from #content
     done

This program can be used to normalize well-formed XML instances. All XML produced by the OMXMLWRITE library has the following properties:

• it uses ASCII encoding only,
• all elements with empty content are represented with an empty tag,
• attributes are quoted using double quotes,
• special characters < and & are represented using the built-in entities < and & whereas
• all other non-ASCII characters are represented as character entities with hexadecimal notation (
 for example).

Functions xml.omxmlwrite-version xml.writer xml.written

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]