Skip to main content
Version: Next

DOM SET XML DECLARATION

DOM SET XML DECLARATION ( elementRef ; encoding {; standalone {; indentation}} )

ParameterTypeDescription
elementRefTextXML element reference
encodingTextXML document character set
standaloneBooleanTrue = document is standalone False (default) = document is not standalone
indentationBoolean*** Obsolete, do not use ***

Description

The DOM SET XML DECLARATION command allows you to define various options that are useful in creating the XML tree set using elementRef. These options concern the encoding and the standalone property of the tree:

  • encoding: Indicates the character set used in the document. By default (if the command is not called), the UTF-8 character set (compressed Unicode) is used.
    Note: If you pass a character set that is not supported by 4D XML commands, UTF-8 will be used. Refer to Character Sets to see the list of character sets supported (UTF-8 is however recommended in most cases).
  • standalone: Indicates whether the tree is standalone (True) or if it needs other files or external resources to operate (False). By default (if the command is not called or if the parameter is omitted), the tree is not standalone. Compatibility note: The indentation parameter is kept for reasons of compatibility with previous versions of 4D but its use is not recommended in 4D v12. From now on, to specify the indentation of the document, it is strongly recommended to use the XML SET OPTIONS command.

Example

The following example sets the encoding to use and the standalone option in the elementRef element:

 DOM SET XML DECLARATION(elementRef;"UTF-16";True)

See also

DOM Create XML Ref
XML SET OPTIONS

Properties

Command number859
Thread safe