DUMP

Synopsis

HELP:   Dumps all elements in raw XML format (also useful for non XML elements)
TYPE:   OBJECT
SYNTAX: DUMP(DATAFMT=BINARY/HEXADECIMAL/NUMERIC,ATTRFMT=BINARY/HEXADECIMAL/NUMERIC,HASHFMT=BINARY/HEXADECIMAL/NUMERIC,INDSIZ=num,INDCHR=SPACE/TABULATOR,BUFSIZ=num,INICNT=num)

Description

The dump method takes lists of arbitrary FLAM elements and dumps them into XML format. For each element list, an <elementList>...<elementList> block is created, containing an arbitrary number of <element>...</element> tags. A FLAM element contains element data, an element type, attributes and a hash, which are represented as body, type, attr and hash attributes, respectively. The attributes attr and hash are optional and only written if they contain any data.

The output format of data, attributes and hashes can be configured independantly. Valid formats are binary (may result in a not wellformed XML document), hexadecimal or numeric (bytes printed as decimal numbers separated by whitespace). The output format configuration is saved as part of the XML document.

The resulting XML document has the following form:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<flam>
  <configuration>
    <dumpFormat>
      <data>...</data>
      <attr>...</attr>
      <hash>...</hash>
    </dumpFormat>
  </configuration>
  <elementList>
    <element type="..." attr="..." hash="...">...</element>
    <element type="..." attr="..." hash="...">...</element>
    ...
  </elementList>
  <elementList>
    ...
  </elementList>
  ...
</flam>

Arguments