XML DOM Helper Functions

DESCRIPTION:

These functions are used by xmlOutputDOM and xmlOutputBuffer to save and manipulate a shared state of the XML object they are creating.

USAGE:

attach.DOM(DOM.obj)
detach.DOM(where = .DOM.attached)
get.DOM(what, default, where = .DOM.attached)
assign.DOM(what, value, where = .DOM.attached)

REQUIRED ARGUMENTS:

DOM.obj
The XML DOM object to attach (return value of xmlOutputDOM or xmlOutputBuffer).
what
Character string giving the name of the object to get or assign.
default
Default value to return if the object cannot be found.
value
Value to assign.

OPTIONAL ARGUMENTS:

where
Database to detach, get value from, or assign value to.

VALUE:

These functions are primarily used for their side effects, and have no useful return values.

SIDE EFFECTS:

attach.DOM attaches the DOM object as a frame so it can be manipulated. Note that only one such object can be attached at a time, so that when you call attach.DOM again, the previously attached object is detached, and you may lose your state information and data! detach.DOM detaches the DOM object currently attached. assign.DOM assigns a value to a variable name in the current state frame. get.DOM retrieves a value from the current state frame.

SEE ALSO:

,