Callback interface for SGML prolog completion/content start events.
This is a SAX extension event interface providing the
startContent event (in addition to the standard SAX
endDTD lexical events) sent after a document
prolog is completely processed and validated.
startContent is sent exactly once after any
events from document prolog.
See also the
ConfigHandler interface providing an
additional callback sent before
in a state where the first non-prolog item has
been encountered in the input instance.
Linkhandler may generate additional artificial
endDTD events wrapping
unparsedEntityDecl events for
dynamically created entities.
endProlog (in Confighandler) and
not paired with corresponding
events, respectively; instead, the end of content is reported
|startContent||Called once before the first content event, after any declaration sets have been parsed, reported and processed.|
Called once before the first content event, after any declaration sets have been parsed, reported and processed.
For asynchronous target environments, a non-falsey return from
startContentindicates to SGML parsing that asynchronous I/O has been initiated from the event handler for this
startContentevent, and will cause the call stack to be rolled up (ie. to return immediately to a top-level event dispatcher loop). In this case, completion callbacks for the respective I/O operations must call
a non-falsey (relevant only for async) return value indicates to the caller to return immediately in turn (roll-up call stack); a falsey/undefined return value indicates the caller can continue b/c no async I/O has been initiated