Name
XMLType.existsNode — Tests node existence having evaluated given XPATH expression.
Synopsis
XMLType.existsNode
(
|
in xpath_expn varchar , |
in
namespace_map
varchar
) ; |
Description
The member function calculates the given XPATH expression
xpath_expn
using
the XML entity of the instance as a context node. If a namespace_map
parameter
is given then the function adds namespace declarations from this parameter into the beginning of
xpath_expn
before the evaluation.
The function returns 1 if the first result of XPATH evaluation is a node or 0 if there are no results or if the first result is not a node.
Parameters
xpath_expn
A text of XPATH expression to evaluate.
namespace_map
A string that is a list of namespace prefix declarations delimited by whitespace characters.
If the xpath_expn
expression also contains a list of declarations then these two
lists are concatenated.
Return Types
The function returns integer 1 or 0
Examples
Example 24.547. A table with an XMLType column
This populates a table with XML data and then reports which rows contain 'empno' element inside 'emp'.
create table TEST_XMLS (I integer primary key, XMLVAL XMLType); insert into TEST_XMLS values (1, XMLType('<emp><empno>221</empno><ename>John</ename></emp>')); insert into TEST_XMLS values (2, XMLType('<po><pono>331</pono><poname>PO_1</poname></po>')); insert into TEST_XMLS values (3, XMLType('<oil-rig xml:id="14a" water="0.413"/><oil-rig xml:id="14b" water="0.402"/>')); select e.I, e.XMLVAL.existsNode('/emp/empno') from TEST_XMLS as e I callret INTEGER NOT NULL INTEGER _______________________________________________________________________________ 1 1 2 0 3 0 3 Rows. -- 00000 msec.