Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## WRITE-EMPTY-ELEMENT( ) method

> Creates an empty XML node in a SAX-writer object.

> Return type: LOGICAL

> Applies to: SAX-writer object handle

> Syntax
>     WRITE-EMPTY-ELEMENT( name [, namespace-URI ] )

> ``name``

> A LONGCHAR expression evaluating to the fully qualified or unqualified name of the element.

> ``namespace-URI``

> A CHARACTER expression evaluating to the URI of the element, or an empty string ("") or the Unknown value (`?`) if the element doesn’t contain a namespace.

> Creates an empty XML node. This method call sets the WRITE-STATUS to SAX-WRITE-TAG.

> If `namespace-URI` is present, then the prefix will be resolved in the following order:

> 1. The method attempts to extract the namespace from the `name`.

> 2. The method attempts to extract the namespace from a previously declared namespace.

> 3. The method attempts to generate the default namespace.

> If the `name` contains a prefix, `namespace-URI` is present, and this is the first instance of the `namespace-URI` then the namespace is added to the element. This is equivalent to calling the DECLARE-NAMESPACE method.

> If only the `name` is present and it contains a prefix, then the SAX-writer attempts to resolve the prefix to a namespace.

> Although this method call appears to be logically equivalent to a START-ELEMENT invocation directly followed by its corresponding END-ELEMENT invocation, the two techniques produce different outputs. The START-ELEMENT and END-ELEMENT methods produce a pair of tags;`<element></element>`. WRITE-EMPTY-ELEMENT produces the empty element tag; `<element/>`.

> If STRICT is TRUE, FRAGMENT is FALSE, and the invocation would result in more than one document-level element, (that is, root node), then the method fails.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095