Oracle®
XML API Reference
10g Release 1 (10.1)
Part No. B10789-01
December 2003
Oracle XML API Reference, 10g Release 1 (10.1)
Part No. B10789-01
Copyright © 2001, 2003 Oracle Corporation. All rights reserved.
Contributing Authors: Stanley Guan, Dmitry Lenkov, Roza Leyderman, Ian Macky, Anguel Novoselsky,
Tomas Saulys, Mark Scardina
The Programs (which include both the software and documentation) contain proprietary information of
Oracle Corporation; they are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyright, patent and other intellectual and industrial property
laws. Reverse engineering, disassembly or decompilation of the Programs, except to the extent required
to obtain interoperability with other independently created software or as specified by law, is prohibited.
The information contained in this document is subject to change without notice. If you find any problems
in the documentation, please report them to us in writing. Oracle Corporation does not warrant that this
document is error-free. Except as may be expressly permitted in your license agreement for these
Programs, no part of these Programs may be reproduced or transmitted in any form or by any means,
electronic or mechanical, for any purpose, without the express written permission of Oracle Corporation.
If the Programs are delivered to the U.S. Government or anyone licensing or using the programs on
behalf of the U.S. Government, the following notice is applicable:
Restricted Rights Notice Programs delivered subject to the DOD FAR Supplement are "commercial
computer software" and use, duplication, and disclosure of the Programs, including documentation,
shall be subject to the licensing restrictions set forth in the applicable Oracle license agreement.
Otherwise, Programs delivered subject to the Federal Acquisition Regulations are "restricted computer
software" and use, duplication, and disclosure of the Programs shall be subject to the restrictions in FAR
52.227-19, Commercial Computer Software - Restricted Rights (June, 1987). Oracle Corporation, 500
Oracle Parkway, Redwood City, CA 94065.
The Programs are not intended for use in any nuclear, aviation, mass transit, medical, or other inherently
dangerous applications. It shall be the licensee's responsibility to take all appropriate fail-safe, backup,

redundancy, and other measures to ensure the safe use of such applications if the Programs are used for
such purposes, and Oracle Corporation disclaims liability for any damages caused by such use of the
Programs.
Oracle is a registered trademark, and Oracle Store, Oracle9i, PL/SQL, and SQL*Plus are trademarks or
registered trademarks of Oracle Corporation. Other names may be trademarks of their respective
owners.
iii
Contents
Send Us Your Comments
............................................................................................................... xxxi
Preface
....................................................................................................................................................... xxxiii
Audience ........................................................................................................................................... xxxiv
Organization..................................................................................................................................... xxxiv
Related Documentation ................................................................................................................... xxxv
Conventions...................................................................................................................................... xxxvi
Documentation Accessibility ........................................................................................................ xxxviii
What's New in Oracle XML API Reference?
........................................................................... xli
10g Release 1 (10.1) ............................................................................................................................... xli
Part I XML APIs for C
1 Mapping Between Old and New C APIs
C Package Changes ............................................................................................................................ 1-2
Initializing and Parsing Sequence Changes.................................................................................. 1-3
Datatype Mapping between oraxml and xml Packages .............................................................. 1-5
Method Mapping between oraxml and xml Packages ................................................................ 1-7
2 Datatypes for C
C Datatypes.......................................................................................................................................... 2-2
xmlcmphow................................................................................................................................... 2-3
iv

xmlctx ............................................................................................................................................. 2-3
xmlerr ............................................................................................................................................. 2-4
xmlistream ..................................................................................................................................... 2-4
xmliter............................................................................................................................................. 2-5
xmlnodetype.................................................................................................................................. 2-5
xmlostream .................................................................................................................................... 2-6
xmlpoint ......................................................................................................................................... 2-7
xmlrange ........................................................................................................................................ 2-7
xmlshowbits................................................................................................................................... 2-8
xmlurlacc........................................................................................................................................ 2-8
xmlurlhdl ....................................................................................................................................... 2-9
xmlurlpart ...................................................................................................................................... 2-9
xmlxptrloc .................................................................................................................................... 2-10
xmlxptrlocset ............................................................................................................................... 2-10
xmlxslobjtype .............................................................................................................................. 2-10
xmlxslomethod............................................................................................................................ 2-10
xmlxvm......................................................................................................................................... 2-11
xmlxvmcomp............................................................................................................................... 2-11
xmlxvmflags ................................................................................................................................ 2-11
xmlxvmobjtype ........................................................................................................................... 2-11
xpctx.............................................................................................................................................. 2-12
xpexpr........................................................................................................................................... 2-12
xpobj ............................................................................................................................................. 2-12
xsdctx............................................................................................................................................ 2-12
xslctx ............................................................................................................................................. 2-13
xvmobj .......................................................................................................................................... 2-13
3 Package Callback APIs for C
Callback Methods ............................................................................................................................... 3-2
XML_ACCESS_CLOSE_F............................................................................................................ 3-2
XML_ACCESS_OPEN_F ............................................................................................................. 3-3

XML_ACCESS_READ_F ............................................................................................................. 3-3
XML_ALLOC_F ............................................................................................................................ 3-4
XML_ERRMSG_F ......................................................................................................................... 3-5
XML_FREE_F ................................................................................................................................ 3-5
v
XML_STREAM_CLOSE_F .......................................................................................................... 3-6
XML_STREAM_OPEN_F ............................................................................................................ 3-6
XML_STREAM_READ_F ............................................................................................................ 3-7
XML_STREAM_WRITE_F .......................................................................................................... 3-8
4 Package DOM APIs for C
Attr Interface........................................................................................................................................ 4-2
XmlDomGetAttrLocal.................................................................................................................. 4-3
XmlDomGetAttrLocalLen ........................................................................................................... 4-3
XmlDomGetAttrName................................................................................................................. 4-4
XmlDomGetAttrNameLen.......................................................................................................... 4-5
XmlDomGetAttrPrefix................................................................................................................. 4-6
XmlDomGetAttrSpecified ........................................................................................................... 4-7
XmlDomGetAttrURI .................................................................................................................... 4-7
XmlDomGetAttrURILen.............................................................................................................. 4-8
XmlDomGetAttrValue................................................................................................................. 4-9
XmlDomGetAttrValueLen ........................................................................................................ 4-10
XmlDomGetAttrValueStream................................................................................................... 4-11
XmlDomGetOwnerElem ........................................................................................................... 4-11
XmlDomSetAttrValue................................................................................................................ 4-12
XmlDomSetAttrValueStream ................................................................................................... 4-13
CharacterData Interface................................................................................................................... 4-14
XmlDomAppendData................................................................................................................ 4-14
XmlDomDeleteData ................................................................................................................... 4-15
XmlDomGetCharData ............................................................................................................... 4-16
XmlDomGetCharDataLength................................................................................................... 4-16

XmlDomInsertData .................................................................................................................... 4-17
XmlDomReplaceData................................................................................................................. 4-18
XmlDomSetCharData ................................................................................................................ 4-19
XmlDomSubstringData ............................................................................................................. 4-19
Document Interface.......................................................................................................................... 4-21
XmlDomCreateAttr .................................................................................................................... 4-22
XmlDomCreateAttrNS............................................................................................................... 4-23
XmlDomCreateCDATA............................................................................................................. 4-24
XmlDomCreateComment.......................................................................................................... 4-25
vi
XmlDomCreateElem .................................................................................................................. 4-26
XmlDomCreateElemNS ............................................................................................................. 4-27
XmlDomCreateEntityRef........................................................................................................... 4-28
XmlDomCreateFragment .......................................................................................................... 4-28
XmlDomCreatePI........................................................................................................................ 4-29
XmlDomCreateText.................................................................................................................... 4-30
XmlDomFreeString..................................................................................................................... 4-31
XmlDomGetBaseURI.................................................................................................................. 4-32
XmlDomGetDTD ........................................................................................................................ 4-32
XmlDomGetDecl......................................................................................................................... 4-33
XmlDomGetDocElem................................................................................................................. 4-34
XmlDomGetDocElemByID........................................................................................................ 4-34
XmlDomGetDocElemsByTag.................................................................................................... 4-35
XmlDomGetDocElemsByTagNS .............................................................................................. 4-36
XmlDomGetLastError................................................................................................................ 4-37
XmlDomGetSchema ................................................................................................................... 4-37
XmlDomImportNode................................................................................................................. 4-38
XmlDomIsSchemaBased............................................................................................................ 4-39
XmlDomSaveString .................................................................................................................... 4-40
XmlDomSaveString2 .................................................................................................................. 4-40

XmlDomSetBaseURI................................................................................................................... 4-41
XmlDomSetDTD ......................................................................................................................... 4-42
XmlDomSetDocOrder ................................................................................................................ 4-43
XmlDomSetLastError................................................................................................................. 4-43
XmlDomSync............................................................................................................................... 4-44
DocumentType Interface ................................................................................................................. 4-45
XmlDomGetDTDEntities........................................................................................................... 4-45
XmlDomGetDTDInternalSubset............................................................................................... 4-46
XmlDomGetDTDName ............................................................................................................. 4-46
XmlDomGetDTDNotations....................................................................................................... 4-47
XmlDomGetDTDPubID............................................................................................................. 4-48
XmlDomGetDTDSysID.............................................................................................................. 4-48
Element Interface .............................................................................................................................. 4-50
XmlDomGetAttr.......................................................................................................................... 4-51
XmlDomGetAttrNS .................................................................................................................... 4-51
vii
XmlDomGetAttrNode ............................................................................................................... 4-52
XmlDomGetAttrNodeNS .......................................................................................................... 4-53
XmlDomGetChildrenByTag...................................................................................................... 4-53
XmlDomGetChildrenByTagNS ................................................................................................ 4-54
XmlDomGetElemsByTag........................................................................................................... 4-55
XmlDomGetElemsByTagNS ..................................................................................................... 4-56
XmlDomGetTag.......................................................................................................................... 4-56
XmlDomHasAttr......................................................................................................................... 4-57
XmlDomHasAttrNS ................................................................................................................... 4-58
XmlDomRemoveAttr ................................................................................................................. 4-58
XmlDomRemoveAttrNS............................................................................................................ 4-59
XmlDomRemoveAttrNode ....................................................................................................... 4-60
XmlDomSetAttr .......................................................................................................................... 4-60
XmlDomSetAttrNS..................................................................................................................... 4-61

XmlDomSetAttrNode ................................................................................................................ 4-62
XmlDomSetAttrNodeNS........................................................................................................... 4-62
Entity Interface.................................................................................................................................. 4-64
XmlDomGetEntityNotation ...................................................................................................... 4-64
XmlDomGetEntityPubID .......................................................................................................... 4-65
XmlDomGetEntitySysID ........................................................................................................... 4-65
XmlDomGetEntityType............................................................................................................. 4-66
NamedNodeMap Interface ............................................................................................................. 4-67
XmlDomGetNamedItem ........................................................................................................... 4-67
XmlDomGetNamedItemNS...................................................................................................... 4-68
XmlDomGetNodeMapItem ...................................................................................................... 4-69
XmlDomGetNodeMapLength.................................................................................................. 4-69
XmlDomRemoveNamedItem ................................................................................................... 4-70
XmlDomRemoveNamedItemNS.............................................................................................. 4-71
XmlDomSetNamedItem ............................................................................................................ 4-71
XmlDomSetNamedItemNS....................................................................................................... 4-72
Node Interface ................................................................................................................................... 4-74
XmlDomAppendChild .............................................................................................................. 4-76
XmlDomCleanNode................................................................................................................... 4-76
XmlDomCloneNode................................................................................................................... 4-77
XmlDomFreeNode ..................................................................................................................... 4-78
viii
XmlDomGetAttrs........................................................................................................................ 4-78
XmlDomGetChildNodes ........................................................................................................... 4-79
XmlDomGetDefaultNS .............................................................................................................. 4-80
XmlDomGetFirstChild............................................................................................................... 4-80
XmlDomGetFirstPfnsPair.......................................................................................................... 4-81
XmlDomGetLastChild ............................................................................................................... 4-81
XmlDomGetNextPfnsPair ......................................................................................................... 4-82
XmlDomGetNextSibling............................................................................................................ 4-83

XmlDomGetNodeLocal ............................................................................................................. 4-83
XmlDomGetNodeLocalLen....................................................................................................... 4-84
XmlDomGetNodeName ............................................................................................................ 4-85
XmlDomGetNodeNameLen...................................................................................................... 4-86
XmlDomGetNodePrefix ............................................................................................................ 4-87
XmlDomGetNodeType.............................................................................................................. 4-87
XmlDomGetNodeURI................................................................................................................ 4-89
XmlDomGetNodeURILen ......................................................................................................... 4-89
XmlDomGetNodeValue............................................................................................................. 4-90
XmlDomGetNodeValueLen...................................................................................................... 4-91
XmlDomGetNodeValueStream ................................................................................................ 4-92
XmlDomGetOwnerDocument.................................................................................................. 4-93
XmlDomGetParentNode ........................................................................................................... 4-93
XmlDomGetPrevSibling ............................................................................................................ 4-94
XmlDomGetSourceEntity .......................................................................................................... 4-95
XmlDomGetSourceLine............................................................................................................. 4-95
XmlDomGetSourceLocation ..................................................................................................... 4-96
XmlDomHasAttrs ....................................................................................................................... 4-96
XmlDomHasChildNodes........................................................................................................... 4-97
XmlDomInsertBefore.................................................................................................................. 4-97
XmlDomNormalize .................................................................................................................... 4-98
XmlDomNumAttrs..................................................................................................................... 4-98
XmlDomNumChildNodes ........................................................................................................ 4-99
XmlDomPrefixToURI................................................................................................................. 4-99
XmlDomRemoveChild............................................................................................................. 4-100
XmlDomReplaceChild ............................................................................................................. 4-101
XmlDomSetDefaultNS ............................................................................................................. 4-101
ix
XmlDomSetNodePrefix ........................................................................................................... 4-102
XmlDomSetNodeValue ........................................................................................................... 4-102

XmlDomSetNodeValueLen..................................................................................................... 4-103
XmlDomSetNodeValueStream............................................................................................... 4-104
XmlDomValidate ...................................................................................................................... 4-105
NodeList Interface .......................................................................................................................... 4-106
XmlDomFreeNodeList............................................................................................................. 4-106
XmlDomGetNodeListItem ...................................................................................................... 4-106
XmlDomGetNodeListLength.................................................................................................. 4-107
Notation Interface........................................................................................................................... 4-109
XmlDomGetNotationPubID ................................................................................................... 4-109
XmlDomGetNotationSysID .................................................................................................... 4-109
ProcessingInstruction Interface ................................................................................................... 4-111
XmlDomGetPIData .................................................................................................................. 4-111
XmlDomGetPITarget ............................................................................................................... 4-112
XmlDomSetPIData ................................................................................................................... 4-112
Text Interface.................................................................................................................................... 4-114
XmlDomSplitText ..................................................................................................................... 4-114
5 Package Range APIs for C
DocumentRange Interface ................................................................................................................ 5-2
XmlDomCreateRange .................................................................................................................. 5-2
Range Interface.................................................................................................................................... 5-3
XmlDomRangeClone ................................................................................................................... 5-4
XmlDomRangeCloneContents ................................................................................................... 5-4
XmlDomRangeCollapse .............................................................................................................. 5-5
XmlDomRangeCompareBoundaryPoints................................................................................. 5-5
XmlDomRangeDeleteContents................................................................................................... 5-6
XmlDomRangeDetach ................................................................................................................. 5-7
XmlDomRangeExtractContents ................................................................................................. 5-7
XmlDomRangeGetCollapsed...................................................................................................... 5-8
XmlDomRangeGetCommonAncestor....................................................................................... 5-8
XmlDomRangeGetDetached....................................................................................................... 5-9

XmlDomRangeGetEndContainer............................................................................................... 5-9
XmlDomRangeGetEndOffset.................................................................................................... 5-10
x
XmlDomRangeGetStartContainer............................................................................................ 5-10
XmlDomRangeGetStartOffset................................................................................................... 5-11
XmlDomRangeIsConsistent ...................................................................................................... 5-12
XmlDomRangeSelectNode........................................................................................................ 5-12
XmlDomRangeSelectNodeContents........................................................................................ 5-13
XmlDomRangeSetEnd ............................................................................................................... 5-13
XmlDomRangeSetEndBefore.................................................................................................... 5-14
XmlDomRangeSetStart .............................................................................................................. 5-15
XmlDomRangeSetStartAfter ..................................................................................................... 5-15
XmlDomRangeSetStartBefore................................................................................................... 5-16
6 Package SAX APIs for C
SAX Interface ....................................................................................................................................... 6-2
XmlSaxAttributeDecl ................................................................................................................... 6-3
XmlSaxCDATA ............................................................................................................................. 6-3
XmlSaxCharacters......................................................................................................................... 6-4
XmlSaxComment .......................................................................................................................... 6-5
XmlSaxElementDecl ..................................................................................................................... 6-5
XmlSaxEndDocument.................................................................................................................. 6-6
XmlSaxEndElement...................................................................................................................... 6-6
XmlSaxNotationDecl.................................................................................................................... 6-7
XmlSaxPI........................................................................................................................................ 6-8
XmlSaxParsedEntityDecl............................................................................................................. 6-8
XmlSaxStartDocument................................................................................................................. 6-9
XmlSaxStartElement................................................................................................................... 6-10
XmlSaxStartElementNS ............................................................................................................. 6-10
XmlSaxUnparsedEntityDecl...................................................................................................... 6-11
XmlSaxWhitespace ..................................................................................................................... 6-12

XmlSaxXmlDecl .......................................................................................................................... 6-13
7 Package Schema APIs for C
Schema Interface ................................................................................................................................. 7-2
XmlSchemaClean.......................................................................................................................... 7-2
XmlSchemaCreate......................................................................................................................... 7-3
XmlSchemaDestroy ...................................................................................................................... 7-3
xi
XmlSchemaErrorWhere............................................................................................................... 7-4
XmlSchemaLoad........................................................................................................................... 7-4
XmlSchemaLoadedList................................................................................................................ 7-5
XmlSchemaSetErrorHandler....................................................................................................... 7-6
XmlSchemaSetValidateOptions.................................................................................................. 7-6
XmlSchemaTargetNamespace.................................................................................................... 7-7
XmlSchemaUnload....................................................................................................................... 7-8
XmlSchemaValidate ..................................................................................................................... 7-8
XmlSchemaVersion ...................................................................................................................... 7-9
8 Package Traversal APIs for C
DocumentTraversal Interface ........................................................................................................... 8-2
XmlDomCreateNodeIter ............................................................................................................. 8-2
XmlDomCreateTreeWalker......................................................................................................... 8-3
NodeFilter Interface ........................................................................................................................... 8-5
XMLDOM_ACCEPT_NODE_F.................................................................................................. 8-5
NodeIterator Interface........................................................................................................................ 8-7
XmlDomIterDetach ...................................................................................................................... 8-7
XmlDomIterNextNode ................................................................................................................ 8-8
XmlDomIterPrevNode................................................................................................................. 8-8
TreeWalker Interface ........................................................................................................................ 8-10
XmlDomWalkerFirstChild ........................................................................................................ 8-10
XmlDomWalkerGetCurrentNode............................................................................................ 8-11
XmlDomWalkerGetRoot ........................................................................................................... 8-11

XmlDomWalkerLastChild......................................................................................................... 8-12
XmlDomWalkerNextNode........................................................................................................ 8-13
XmlDomWalkerNextSibling ..................................................................................................... 8-13
XmlDomWalkerParentNode..................................................................................................... 8-14
XmlDomWalkerPrevNode........................................................................................................ 8-15
XmlDomWalkerPrevSibling ..................................................................................................... 8-15
XmlDomWalkerSetCurrentNode............................................................................................. 8-16
XmlDomWalkerSetRoot ............................................................................................................ 8-17
9 Package XML APIs for C
XML Interface...................................................................................................................................... 9-2
xii
XmlAccess...................................................................................................................................... 9-2
XmlCreate ...................................................................................................................................... 9-4
XmlCreateDTD.............................................................................................................................. 9-6
XmlCreateDocument.................................................................................................................... 9-7
XmlDestroy.................................................................................................................................... 9-7
XmlFreeDocument........................................................................................................................ 9-8
XmlGetEncoding........................................................................................................................... 9-8
XmlHasFeature.............................................................................................................................. 9-9
XmlIsSimple................................................................................................................................. 9-10
XmlIsUnicode.............................................................................................................................. 9-10
XmlLoadDom .............................................................................................................................. 9-11
XmlLoadSax................................................................................................................................. 9-13
XmlLoadSaxVA........................................................................................................................... 9-13
XmlSaveDom............................................................................................................................... 9-14
XmlVersion .................................................................................................................................. 9-15
10 Package XPath APIs for C
XPath Interface .................................................................................................................................. 10-2
XmlXPathCreateCtx ................................................................................................................... 10-2
XmlXPathDestroyCtx................................................................................................................. 10-3

XmlXPathEval ............................................................................................................................. 10-3
XmlXPathGetObjectBoolean ..................................................................................................... 10-4
XmlXPathGetObjectFragment................................................................................................... 10-4
XmlXPathGetObjectNSetNode ................................................................................................. 10-5
XmlXPathGetObjectNSetNum.................................................................................................. 10-5
XmlXPathGetObjectNumber..................................................................................................... 10-6
XmlXPathGetObjectString......................................................................................................... 10-7
XmlXPathGetObjectType........................................................................................................... 10-7
XmlXPathParse............................................................................................................................ 10-8
11 Package XPointer APIs for C
XPointer Interface ............................................................................................................................. 11-2
XmlXPointerEval ........................................................................................................................ 11-2
XPtrLoc Interface............................................................................................................................... 11-3
XmlXPtrLocGetNode ................................................................................................................. 11-3
xiii
XmlXPtrLocGetPoint.................................................................................................................. 11-3
XmlXPtrLocGetRange................................................................................................................ 11-4
XmlXPtrLocGetType .................................................................................................................. 11-4
XmlXPtrLocToString.................................................................................................................. 11-5
XPtrLocSet Interface......................................................................................................................... 11-6
XmlXPtrLocSetFree .................................................................................................................... 11-6
XmlXPtrLocSetGetItem.............................................................................................................. 11-6
XmlXPtrLocSetGetLength ......................................................................................................... 11-7
12 Package XSLT APIs for C
XSLT Interface ................................................................................................................................... 12-2
XmlXslCreate............................................................................................................................... 12-2
XmlXslDestroy ............................................................................................................................ 12-3
XmlXslGetBaseURI..................................................................................................................... 12-3
XmlXslGetOutput....................................................................................................................... 12-4
XmlXslGetStylesheetDom ......................................................................................................... 12-4

XmlXslGetTextParam................................................................................................................. 12-5
XmlXslProcess............................................................................................................................. 12-5
XmlXslResetAllParams.............................................................................................................. 12-6
XmlXslSetOutputDom ............................................................................................................... 12-6
XmlXslSetOutputEncoding....................................................................................................... 12-7
XmlXslSetOutputMethod.......................................................................................................... 12-7
XmlXslSetOutputSax.................................................................................................................. 12-8
XmlXslSetOutputStream ........................................................................................................... 12-8
XmlXslSetTextParam.................................................................................................................. 12-9
13 Package XSLTVM APIs for C
Using XSLTVM ................................................................................................................................. 13-2
XSLTC Interface ................................................................................................................................ 13-3
XmlXvmCompileBuffer ............................................................................................................. 13-3
XmlXvmCompileDom ............................................................................................................... 13-4
XmlXvmCompileFile.................................................................................................................. 13-5
XmlXvmCompileURI................................................................................................................. 13-6
XmlXvmCompileXPath ............................................................................................................. 13-7
XmlXvmCreateComp................................................................................................................. 13-8
xiv
XmlXvmDestroyComp............................................................................................................... 13-8
XmlXvmGetBytecodeLength .................................................................................................... 13-9
XSLTVM Interface .......................................................................................................................... 13-10
XMLXVM_DEBUG_F............................................................................................................... 13-11
XmlXvmCreate.......................................................................................................................... 13-12
XmlXvmDestroy ....................................................................................................................... 13-12
XmlXvmEvaluateXPath ........................................................................................................... 13-13
XmlXvmGetObjectBoolean...................................................................................................... 13-13
XmlXvmGetObjectNSetNode ................................................................................................. 13-14
XmlXvmGetObjectNSetNum.................................................................................................. 13-15
XmlXvmGetObjectNumber..................................................................................................... 13-15

XmlXvmGetObjectString ......................................................................................................... 13-16
XmlXvmGetObjectType........................................................................................................... 13-16
XmlXvmGetOutputDom ......................................................................................................... 13-17
XmlXvmResetParams............................................................................................................... 13-17
XmlXvmSetBaseURI................................................................................................................. 13-18
XmlXvmSetBytecodeBuffer..................................................................................................... 13-18
XmlXvmSetBytecodeFile ......................................................................................................... 13-19
XmlXvmSetBytecodeURI......................................................................................................... 13-19
XmlXvmSetDebugFunc............................................................................................................ 13-20
XmlXvmSetOutputDom .......................................................................................................... 13-21
XmlXvmSetOutputEncoding .................................................................................................. 13-21
XmlXvmSetOutputSax............................................................................................................. 13-22
XmlXvmSetOutputStream....................................................................................................... 13-22
XmlXvmSetTextParam............................................................................................................. 13-23
XmlXvmTransformBuffer........................................................................................................ 13-23
XmlXvmTransformDom.......................................................................................................... 13-24
XmlXvmTransformFile ............................................................................................................ 13-25
XmlXvmTransformURI............................................................................................................ 13-25
Part II XML APIs for C++
14 Package Ctx APIs for C++
Ctx Datatypes..................................................................................................................................... 14-2
encoding....................................................................................................................................... 14-2
xv
encodings ..................................................................................................................................... 14-2
MemAllocator Interface................................................................................................................... 14-3
alloc............................................................................................................................................... 14-3
dealloc .......................................................................................................................................... 14-3
~MemAllocator........................................................................................................................... 14-4
TCtx Interface .................................................................................................................................... 14-5
TCtx .............................................................................................................................................. 14-5

getEncoding................................................................................................................................. 14-6
getErrHandler ............................................................................................................................. 14-6
getMemAllocator........................................................................................................................ 14-7
isSimple........................................................................................................................................ 14-7
isUnicode ..................................................................................................................................... 14-7
~TCtx............................................................................................................................................ 14-8
15 Package Dom APIs for C++
Using Dom ......................................................................................................................................... 15-3
Dom Datatypes.................................................................................................................................. 15-4
AcceptNodeCodes...................................................................................................................... 15-4
CompareHowCode .................................................................................................................... 15-4
DOMNodeType .......................................................................................................................... 15-5
DOMExceptionCode .................................................................................................................. 15-5
WhatToShowCode ..................................................................................................................... 15-6
RangeExceptionCode................................................................................................................. 15-6
AttrRef Interface ............................................................................................................................... 15-7
AttrRef.......................................................................................................................................... 15-7
getName....................................................................................................................................... 15-8
getOwnerElement....................................................................................................................... 15-8
getSpecified ................................................................................................................................. 15-8
getValue ....................................................................................................................................... 15-9
setValue........................................................................................................................................ 15-9
~AttrRef ....................................................................................................................................... 15-9
CDATASectionRef Interface......................................................................................................... 15-11
CDATASectionRef.................................................................................................................... 15-11
~CDATASectionRef ................................................................................................................. 15-11
CharacterDataRef Interface .......................................................................................................... 15-13
xvi
appendData ............................................................................................................................... 15-13
deleteData .................................................................................................................................. 15-14

freeString.................................................................................................................................... 15-14
getData ....................................................................................................................................... 15-14
getLength ................................................................................................................................... 15-15
insertData................................................................................................................................... 15-15
replaceData ................................................................................................................................ 15-16
setData........................................................................................................................................ 15-16
substringData ............................................................................................................................ 15-17
CommentRef Interface................................................................................................................... 15-18
CommentRef.............................................................................................................................. 15-18
~CommentRef ........................................................................................................................... 15-18
DOMException Interface............................................................................................................... 15-20
getDOMCode ............................................................................................................................ 15-20
getMesLang ............................................................................................................................... 15-20
getMessage................................................................................................................................. 15-21
DOMImplRef Interface ................................................................................................................. 15-22
DOMImplRef............................................................................................................................. 15-22
createDocument ........................................................................................................................ 15-23
createDocumentType ............................................................................................................... 15-23
getImplementation ................................................................................................................... 15-24
getNoMod.................................................................................................................................. 15-24
hasFeature.................................................................................................................................. 15-25
setContext .................................................................................................................................. 15-25
~DOMImplRef .......................................................................................................................... 15-26
DOMImplementation Interface ................................................................................................... 15-27
DOMImplementation............................................................................................................... 15-27
getNoMod.................................................................................................................................. 15-27
~DOMImplementation ............................................................................................................ 15-28
DocumentFragmentRef Interface ................................................................................................ 15-29
DocumentFragmentRef............................................................................................................ 15-29
~DocumentFragmentRef ......................................................................................................... 15-29

DocumentRange Interface............................................................................................................. 15-31
DocumentRange........................................................................................................................ 15-31
createRange................................................................................................................................ 15-31
xvii
destroyRange............................................................................................................................. 15-32
~DocumentRange..................................................................................................................... 15-32
DocumentRef Interface.................................................................................................................. 15-33
DocumentRef............................................................................................................................. 15-34
createAttribute .......................................................................................................................... 15-34
createAttributeNS..................................................................................................................... 15-35
createCDATASection ............................................................................................................... 15-35
createComment......................................................................................................................... 15-36
createDocumentFragment....................................................................................................... 15-36
createElement............................................................................................................................ 15-37
createElementNS....................................................................................................................... 15-37
createEntityReference .............................................................................................................. 15-38
createProcessingInstruction .................................................................................................... 15-39
createTextNode......................................................................................................................... 15-39
getDoctype................................................................................................................................. 15-40
getDocumentElement .............................................................................................................. 15-40
getElementById......................................................................................................................... 15-41
getElementsByTagName ......................................................................................................... 15-41
getElementsByTagNameNS.................................................................................................... 15-42
getImplementation ................................................................................................................... 15-43
importNode ............................................................................................................................... 15-43
~DocumentRef .......................................................................................................................... 15-44
DocumentTraversal Interface ....................................................................................................... 15-45
DocumentTraversal.................................................................................................................. 15-45
createNodeIterator.................................................................................................................... 15-45
createTreeWalker...................................................................................................................... 15-46

destroyNodeIterator................................................................................................................. 15-46
destroyTreeWalker................................................................................................................... 15-47
~DocumentTraversal ............................................................................................................... 15-47
DocumentTypeRef Interface......................................................................................................... 15-48
DocumentTypeRef.................................................................................................................... 15-48
getEntities .................................................................................................................................. 15-49
getInternalSubset...................................................................................................................... 15-49
getName..................................................................................................................................... 15-49
getNotations .............................................................................................................................. 15-50
xviii
getPublicId................................................................................................................................. 15-50
getSystemId ............................................................................................................................... 15-50
~DocumentTypeRef ................................................................................................................. 15-51
ElementRef Interface...................................................................................................................... 15-52
ElementRef................................................................................................................................. 15-52
getAttribute................................................................................................................................ 15-53
getAttributeNS .......................................................................................................................... 15-54
getAttributeNode...................................................................................................................... 15-54
getElementsByTagName ......................................................................................................... 15-55
getTagName .............................................................................................................................. 15-55
hasAttribute............................................................................................................................... 15-55
hasAttributeNS.......................................................................................................................... 15-56
removeAttribute........................................................................................................................ 15-56
removeAttributeNS .................................................................................................................. 15-57
removeAttributeNode.............................................................................................................. 15-57
setAttribute ................................................................................................................................ 15-58
setAttributeNS........................................................................................................................... 15-58
setAttributeNode ...................................................................................................................... 15-59
~ElementRef .............................................................................................................................. 15-59
EntityRef Interface.......................................................................................................................... 15-60

EntityRef..................................................................................................................................... 15-60
getNotationName ..................................................................................................................... 15-61
getPublicId................................................................................................................................. 15-61
getSystemId ............................................................................................................................... 15-61
getType....................................................................................................................................... 15-62
~EntityRef .................................................................................................................................. 15-62
EntityReferenceRef Interface ....................................................................................................... 15-63
EntityReferenceRef ................................................................................................................... 15-63
~EntityReferenceRef................................................................................................................. 15-63
NamedNodeMapRef Interface ..................................................................................................... 15-65
NamedNodeMapRef ................................................................................................................ 15-65
getLength ................................................................................................................................... 15-66
getNamedItem........................................................................................................................... 15-66
getNamedItemNS ..................................................................................................................... 15-66
item ............................................................................................................................................. 15-67
xix
removeNamedItem .................................................................................................................. 15-67
removeNamedItemNS............................................................................................................. 15-68
setNamedItem........................................................................................................................... 15-68
setNamedItemNS ..................................................................................................................... 15-69
~NamedNodeMapRef ............................................................................................................. 15-69
NodeFilter Interface ....................................................................................................................... 15-70
acceptNode ................................................................................................................................ 15-70
NodeIterator Interface.................................................................................................................... 15-71
adjustCtx .................................................................................................................................... 15-71
detach ......................................................................................................................................... 15-71
nextNode.................................................................................................................................... 15-72
previousNode............................................................................................................................ 15-72
NodeListRef Interface.................................................................................................................... 15-73
NodeListRef............................................................................................................................... 15-73

getLength ................................................................................................................................... 15-74
item ............................................................................................................................................. 15-74
~NodeListRef ............................................................................................................................ 15-74
NodeRef Interface........................................................................................................................... 15-75
NodeRef ..................................................................................................................................... 15-76
appendChild.............................................................................................................................. 15-77
cloneNode.................................................................................................................................. 15-77
getAttributes.............................................................................................................................. 15-78
getChildNodes .......................................................................................................................... 15-78
getFirstChild.............................................................................................................................. 15-79
getLastChild .............................................................................................................................. 15-79
getLocalName ........................................................................................................................... 15-79
getNamespaceURI.................................................................................................................... 15-80
getNextSibling........................................................................................................................... 15-80
getNoMod.................................................................................................................................. 15-80
getNodeName........................................................................................................................... 15-81
getNodeType............................................................................................................................. 15-81
getNodeValue ........................................................................................................................... 15-81
getOwnerDocument................................................................................................................. 15-82
getParentNode .......................................................................................................................... 15-82
getPrefix ..................................................................................................................................... 15-82
xx
getPreviousSibling.................................................................................................................... 15-83
hasAttributes ............................................................................................................................. 15-83
hasChildNodes.......................................................................................................................... 15-83
insertBefore................................................................................................................................ 15-84
isSupported................................................................................................................................ 15-84
markToDelete............................................................................................................................ 15-85
normalize ................................................................................................................................... 15-85
removeChild.............................................................................................................................. 15-85

replaceChild............................................................................................................................... 15-86
resetNode................................................................................................................................... 15-86
setNodeValue ............................................................................................................................ 15-87
setPrefix...................................................................................................................................... 15-87
~NodeRef ................................................................................................................................... 15-88
NotationRef Interface..................................................................................................................... 15-89
NotationRef................................................................................................................................ 15-89
getPublicId................................................................................................................................. 15-90
getSystemId ............................................................................................................................... 15-90
~NotationRef ............................................................................................................................. 15-90
ProcessingInstructionRef Interface............................................................................................. 15-91
ProcessingInstructionRef......................................................................................................... 15-91
getData ....................................................................................................................................... 15-92
getTarget .................................................................................................................................... 15-92
setData........................................................................................................................................ 15-92
~ProcessingInstructionRef....................................................................................................... 15-93
Range Interface................................................................................................................................ 15-94
CompareBoundaryPoints ........................................................................................................ 15-95
cloneContent.............................................................................................................................. 15-95
cloneRange................................................................................................................................. 15-95
deleteContents........................................................................................................................... 15-96
detach.......................................................................................................................................... 15-96
extractContent ........................................................................................................................... 15-96
getCollapsed .............................................................................................................................. 15-96
getCommonAncestorContainer.............................................................................................. 15-97
getEndContainer....................................................................................................................... 15-97
getEndOffset.............................................................................................................................. 15-97
xxi
getStartContainer...................................................................................................................... 15-98
getStartOffset............................................................................................................................. 15-98

insertNode ................................................................................................................................. 15-98
selectNodeContent ................................................................................................................... 15-99
selectNode ................................................................................................................................. 15-99
setEnd......................................................................................................................................... 15-99
setEndAfter.............................................................................................................................. 15-100
setEndBefore............................................................................................................................ 15-100
setStart...................................................................................................................................... 15-101
setStartAfter............................................................................................................................. 15-101
setStartBefore........................................................................................................................... 15-101
surroundContents................................................................................................................... 15-102
toString..................................................................................................................................... 15-102
RangeException Interface............................................................................................................ 15-103
getCode .................................................................................................................................... 15-103
getMesLang ............................................................................................................................. 15-103
getMessage .............................................................................................................................. 15-104
getRangeCode ......................................................................................................................... 15-104
TextRef Interface........................................................................................................................... 15-105
TextRef ..................................................................................................................................... 15-105
splitText.................................................................................................................................... 15-106
~TextRef................................................................................................................................... 15-106
TreeWalker Interface .................................................................................................................... 15-107
adjustCtx .................................................................................................................................. 15-107
firstChild .................................................................................................................................. 15-107
lastChild................................................................................................................................... 15-108
nextNode.................................................................................................................................. 15-108
nextSibling ............................................................................................................................... 15-108
parentNode.............................................................................................................................. 15-109
previousNode.......................................................................................................................... 15-109
previousSibling ....................................................................................................................... 15-109
16 Package IO APIs for C++

IO Datatypes...................................................................................................................................... 16-2
InputSourceType ........................................................................................................................ 16-2
xxii
InputSource Interface....................................................................................................................... 16-3
getBaseURI................................................................................................................................... 16-3
getISrcType .................................................................................................................................. 16-3
setBaseURI ................................................................................................................................... 16-3
17 Package OracleXml APIs for C++
XmlException Interface.................................................................................................................... 17-2
getCode ........................................................................................................................................ 17-2
getMesLang ................................................................................................................................. 17-2
getMessage................................................................................................................................... 17-3
18 Package Parser APIs for C++
Parser Datatypes................................................................................................................................ 18-2
ParserExceptionCode ................................................................................................................. 18-2
DOMParserIdType ..................................................................................................................... 18-2
SAXParserIdType ....................................................................................................................... 18-3
SchValidatorIdType.................................................................................................................... 18-3
DOMParser Interface ....................................................................................................................... 18-4
getContext.................................................................................................................................... 18-4
getParserId................................................................................................................................... 18-4
parse.............................................................................................................................................. 18-5
parseDTD ..................................................................................................................................... 18-5
parseSchVal ................................................................................................................................. 18-6
setValidator.................................................................................................................................. 18-6
GParser Interface............................................................................................................................... 18-8
SetWarnDuplicateEntity ............................................................................................................ 18-8
getBaseURI................................................................................................................................... 18-9
getDiscardWhitespaces.............................................................................................................. 18-9
getExpandCharRefs.................................................................................................................... 18-9

getSchemaLocation................................................................................................................... 18-10
getStopOnWarning................................................................................................................... 18-10
getWarnDuplicateEntity.......................................................................................................... 18-10
setBaseURI ................................................................................................................................. 18-11
setDiscardWhitespaces ............................................................................................................ 18-11
setExpandCharRefs .................................................................................................................. 18-12
xxiii
setSchemaLocation ................................................................................................................... 18-12
setStopOnWarning ................................................................................................................... 18-12
ParserException Interface.............................................................................................................. 18-14
getCode ...................................................................................................................................... 18-14
getMesLang ............................................................................................................................... 18-14
getMessage ................................................................................................................................ 18-15
getParserCode ........................................................................................................................... 18-15
SAXHandler Interface.................................................................................................................... 18-16
CDATA ...................................................................................................................................... 18-16
XMLDecl .................................................................................................................................... 18-17
attributeDecl.............................................................................................................................. 18-17
characters ................................................................................................................................... 18-18
comment..................................................................................................................................... 18-18
elementDecl ............................................................................................................................... 18-19
endDocument............................................................................................................................ 18-19
endElement................................................................................................................................ 18-19
notationDecl .............................................................................................................................. 18-20
parsedEntityDecl ...................................................................................................................... 18-20
processingInstruction............................................................................................................... 18-21
startDocument........................................................................................................................... 18-21
startElement............................................................................................................................... 18-21
startElementNS ......................................................................................................................... 18-22
unparsedEntityDecl.................................................................................................................. 18-22

whitespace ................................................................................................................................. 18-23
SAXParser Interface........................................................................................................................ 18-24
getContext.................................................................................................................................. 18-24
getParserId................................................................................................................................. 18-24
parse ........................................................................................................................................... 18-25
parseDTD................................................................................................................................... 18-25
setSAXHandler.......................................................................................................................... 18-26
SchemaValidator Interface............................................................................................................ 18-27
getSchemaList ........................................................................................................................... 18-27
getValidatorId ........................................................................................................................... 18-27
loadSchema................................................................................................................................ 18-28
unloadSchema........................................................................................................................... 18-28
xxiv
19 Package Tools APIs for C++
Tools Datatypes ................................................................................................................................. 19-2
FactoryExceptionCode ............................................................................................................... 19-2
Factory Interface................................................................................................................................ 19-3
Factory.......................................................................................................................................... 19-3
createDOMParser........................................................................................................................ 19-4
createSAXParser.......................................................................................................................... 19-4
createSchemaValidator .............................................................................................................. 19-5
createXPathCompProcessor ...................................................................................................... 19-5
createXPathCompiler ................................................................................................................. 19-6
createXPathProcessor................................................................................................................. 19-6
createXPointerProcessor ............................................................................................................ 19-7
createXslCompiler ...................................................................................................................... 19-7
createXslExtendedTransformer ................................................................................................ 19-8
createXslTransformer ................................................................................................................. 19-8
getContext.................................................................................................................................... 19-9
~Factory........................................................................................................................................ 19-9

FactoryException Interface ............................................................................................................ 19-10
getCode ...................................................................................................................................... 19-10
getFactoryCode ......................................................................................................................... 19-10
getMesLang ............................................................................................................................... 19-11
getMessage................................................................................................................................. 19-11
20 Package XPath APIs for C++
XPath Datatypes ................................................................................................................................ 20-2
XPathCompIdType..................................................................................................................... 20-2
XPathObjType ............................................................................................................................. 20-2
XPathExceptionCode.................................................................................................................. 20-3
XPathPrIdType............................................................................................................................ 20-3
CompProcessor Interface................................................................................................................. 20-4
getProcessorId............................................................................................................................. 20-4
process .......................................................................................................................................... 20-4
processWithBinXPath................................................................................................................. 20-5
Compiler Interface............................................................................................................................ 20-6
compile ......................................................................................................................................... 20-6
xxv
getCompilerId ............................................................................................................................. 20-6
NodeSet Interface ............................................................................................................................. 20-8
getNode........................................................................................................................................ 20-8
getSize .......................................................................................................................................... 20-8
Processor Interface.......................................................................................................................... 20-10
getProcessorId........................................................................................................................... 20-10
process........................................................................................................................................ 20-10
XPathException Interface .............................................................................................................. 20-12
getCode ...................................................................................................................................... 20-12
getMesLang ............................................................................................................................... 20-12
getMessage ................................................................................................................................ 20-13
getXPathCode............................................................................................................................ 20-13

XPathObject Interface.................................................................................................................... 20-14
XPathObject ............................................................................................................................... 20-14
getNodeSet ................................................................................................................................ 20-14
getObjBoolean ........................................................................................................................... 20-15
getObjNumber .......................................................................................................................... 20-15
getObjString............................................................................................................................... 20-15
getObjType ................................................................................................................................ 20-15
21 Package XPointer APIs for C++
XPointer Datatypes........................................................................................................................... 21-2
XppExceptionCode..................................................................................................................... 21-2
XppPrIdType............................................................................................................................... 21-2
XppLocType ................................................................................................................................ 21-2
Processor Interface............................................................................................................................ 21-4
getProcessorId............................................................................................................................. 21-4
process.......................................................................................................................................... 21-4
XppException Interface.................................................................................................................... 21-6
getCode ........................................................................................................................................ 21-6
getMesLang ................................................................................................................................. 21-6
getMessage .................................................................................................................................. 21-7
getXppCode................................................................................................................................. 21-7
XppLocation Interface...................................................................................................................... 21-8
getLocType .................................................................................................................................. 21-8