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.