All of these functions must return a BYVALUE FIXED BIN(31)
value that is a return code to the parser. For the parser to continue
normally, this value should be zero.
All of these functions will be passed as the first argument a
BYVALUE POINTER that is the token value passed originally as the
second argument to the built-in function.
With the following exceptions, all of the functions will also
be passed a BYVALUE POINTER and a BYVALUE FIXED BIN(31) that supply
the address and length of the text element for the event. The functions/events
that are different are:
- end_of_document
- No argument other than the user token is passed.
- attribute_predefined_reference
- In addition to the user token, one additional argument is
passed: a BYVALUE CHAR(1) or, for a UTF-16 document, a
BYVALUE WIDECHAR(1) that holds the value of the predefined character.
- content_predefined_reference
- In addition to the user token, one additional argument is
passed: a BYVALUE CHAR(1) or, for a UTF-16 document, a
BYVALUE WIDECHAR(1) that holds the value of the predefined character.
- attribute_character_reference
- In addition to the user token, one additional argument is
passed: a BYVALUE FIXED BIN(31) that holds the value of
the numeric reference.
- content_character_reference
- In addition to the user token, one additional argument is
passed: a BYVALUE FIXED BIN(31) that holds the value of
the numeric reference.
- processing_instruction
- In addition to the user token, four additional arguments are
passed:
- a BYVALUE POINTER that is the address of the target text
- a BYVALUE FIXED BIN(31) that is the length of the target text
- a BYVALUE POINTER that is the address of the data text
- a BYVALUE FIXED BIN(31) that is the length of the data text
- exception
- In addition to the user token, three additional arguments
are passed:
- a BYVALUE POINTER that is the address of the offending text
- a BYVALUE FIXED BIN(31) that is the byte offset of the offending
text within the document
- a BYVALUE FIXED BIN(31) that is the value of the exception code
|
This information center is powered by Eclipse technology. (http://www.eclipse.org)