PARSER

PARSER is a parser handle type used to hold a parser instance in variables or parameters. The instance must be created using NEWPARSER and released using FREEPARSER. It also serves as a transfer medium between subprograms such as PARSECLOB and GETDOCUMENT. The handle itself is an opaque type.

Syntax

parser DBMS_XMLPARSER.PARSER;

Parameters

Return value

Parser handle.

Usage instructions

DBMS_XMLPARSER.PARSER is a private type used to declare parser handles in PL variables. It cannot be directly instantiated and must be generated using the NEWPARSER subprogram.

Related subprograms

Examples

This example creates an XML parser instance using the DBMS_XMLPARSER system package and then releases the parser handle:

-- Declare the parser handle variable
DECLARE
  p DBMS_XMLPARSER.PARSER;
BEGIN
  -- Create a parser instance
  p := DBMS_XMLPARSER.NEWPARSER;
  -- Release the parser handle.
  DBMS_XMLPARSER.FREEPARSER(p);
END;
/