DBMS_XMLDOM

構文

DBMS_XMLDOM.APPENDCHILD(
   n          IN    DOMNode,
   newchild   IN    DOMNode)
 RETURN DOMNODE;

パラメータ

表206-23 APPENDCHILDファンクションのパラメータ

パラメータ	説明
`n`	`DOMNode`
`newchild`	ノード`n`の子ノード・リストに追加する子ノード。

206.7.3 APPENDDATAプロシージャ

このプロシージャは、ノードの文字データの最後に文字列を追加します。データが正常に追加されると、連結データと指定の文字列引数にアクセスできます。

参照:

構文

DBMS_XMLDOM.APPENDDATA(
   cd      IN    DOMCHARACTERDATA, 
   arg     IN    VARCHAR2);

パラメータ

表206-24 APPENDDATAプロシージャのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`arg`	既存のデータに追加するデータ。

206.7.4 CLONENODEファンクション

このファンクションは、指定したノードの複製を戻し、ノードの汎用コピー・コンストラクタとして機能します。複製ノードに親はないため、複製ノードの親ノードはNULLになります。

参照:

構文

DBMS_XMLDOM.CLONENODE(
   n       IN    DOMNODE,
   deep    IN    BOOLEAN)
 RETURN DOMNODE;

パラメータ

表206-25 CLONENODEファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`
`deep`	子がクローニング対象かどうかを指定します。

使用上のノート

要素のクローニングによって、すべての属性とその値(デフォルトの属性を示すためにXMLプロセッサで生成された値を含む)がコピーされます。ただし、このメソッドは、ディープ・クローンの場合を除き、格納されているテキストをコピーしません。これは、テキストが子のテキスト・ノードに格納されているためです。
属性の直接クローニングでは、要素のクローニング操作の一部としてクローニングする場合とは対照的に、指定した属性(TRUEに指定)が戻されます。
別の型のノードを複製すると、このノードのコピーが返されます。

206.7.5 CREATEATTRIBUTEファンクション

このファンクションは、DOMATTRノードを作成します。

参照:

構文

指定した名前を持つDOMATTRノードを作成します。

DBMS_XMLDOM.CREATEATTRIBUTE(
   doc     IN    DOMDOCUMENT,
   name    IN    VARCHAR2)
 RETURN DOMATTR;

指定した名前と名前空間URIを持つDOMATTRノードを作成します。

DBMS_XMLDOM.CREATEATTRIBUTE(
   doc     IN    DOMDOCUMENT,
   qname    IN    VARCHAR2,
   ns      IN     VARCHAR2)
RETURN DOMATTR;

パラメータ

表206-26 CREATEATTRIBUTEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`qname`	新規の属性修飾名。
`ns`	ネームスペース

206.7.6 CREATECDATASECTIONファンクション

このファンクションは、DOMCDATASECTIONノードを作成します。

参照:

構文

DBMS_XMLDOM.CREATECDATASECTION(
   doc     IN      DOMDOCUMENT,
   data    IN      VARCHAR2)
 RETURN DOMCDATASECTION;

パラメータ

表206-27 CREATECDATASECTIONファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`data`	`DOMCDATASECTION`ノードの内容。

206.7.7 CREATECOMMENTファンクション

このファンクションは、DOMCOMMENTノードを作成します。

参照:

構文

DBMS_XMLDOM.CREATECOMMENT(
   doc      IN      DOMDOCUMENT,
   data     IN      VARCHAR2)
 RETURN DOMCOMMENT;

パラメータ

表206-28 CREATECOMMENTファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`data`	`DOMComment`ノードの内容。

206.7.8 CREATEDOCUMENTファンクション

このファンクションは、指定した名前空間URI、ルート要素名、DTDを持つDOMDOCUMENTノードを作成します。

参照:

構文

DBMS_XMLDOM.CREATEDOCUMENT(
   namespaceURI      IN     VARCHAR2,
   qualifiedName     IN     VARCHAR2,
   doctype           IN     DOMTYPE := NULL)
 RETURN DOMDOCUMENT;

パラメータ

表206-29 CREATEDOCUMENTファンクションのパラメータ

パラメータ	説明
`namespaceURI`	名前空間URI
`qualifiedName`	ルート要素名
`doctype`	ドキュメント・タイプ

206.7.9 CREATEDOCUMENTFRAGMENTファンクション

このファンクションは、DOMDOCUMENTFRAGMENTを作成します。

参照:

構文

DBMS_XMLDOM.CREATEDOCUMENTFRAGMENT(
   doc      IN     DOMDOCUMENT)
 RETURN DOMDOCUMENTFRAGMENT;

パラメータ

表206-30 CREATEDOCUMENTFRAGMENTファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDocument`

206.7.10 CREATEELEMENTファンクション

このファンクションは、DOMELEMENTを作成します。

参照:

構文

指定した名前を持つDOMElementを作成します。

DBMS_XMLDOM.CREATEELEMENT(
   doc        IN      DOMDOCUMENT,
   tagName    IN      VARCHAR2)
 RETURN DOMELEMENT;

指定した名前と名前空間URIを持つDOMElementを作成します。

DBMS_XMLDOM.CREATEELEMENT(
   doc        IN     DOMDOCUMENT,
   tagName    IN     VARCHAR2,
   ns         IN     VARCHAR2)
 RETURN DOMELEMENT;

パラメータ

表206-31 CREATEELEMENTファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`tagName`	新しい`DOMELEMENT`のタグ名。
`ns`	ネームスペース

206.7.11 CREATEENTITYREFERENCEファンクション

このファンクションは、DOMENTITYREFERENCEノードを作成します。

参照:

構文

DBMS_XMLDOM.CREATEENTITYREFERENCE(
   doc        IN     DOMDOCUMENT,
   name       IN     VARCHAR2)
 RETURN DOMENTITYREFERENCE;

パラメータ

表206-32 CREATEENTITYREFERENCEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`name`	新規の実体参照の名前。

206.7.12 CREATEPROCESSINGINSTRUCTIONファンクション

このファンクションは、DOMPROCESSINGINSTRUCTIONノードを作成します。

参照:

構文

DBMS_XMLDOM.CREATEPROCESSINGINSTRUCTION(
   doc       IN      DOMDocument,
   target    IN      VARCHAR2,
   data      IN      VARCHAR2)
 RETURN DOMPROCESSINGINSTRUCTION;

パラメータ

表206-33 CREATEPROCESSINGINSTRUCTIONファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`target`	新規の処理命令のターゲット。
`data`	新規の処理命令のコンテンツ・データ。

206.7.13 CREATETEXTNODEファンクション

このファンクションは、DOMTEXTノードを作成します。

参照:

構文

DBMS_XMLDOM.CREATETEXTNODE(
   doc      IN     DOMDocument,
   data     IN     VARCHAR2)
 RETURN DOMTEXT;

パラメータ

表206-34 CREATETEXTNODEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`data`	`DOMText`ノードの内容。

206.7.14 DELETEDATAプロシージャ

このプロシージャは、特定範囲の文字をノードから削除します。正常に削除されると、データと長さに変更が反映されます。

参照:

構文

DBMS_XMLDOM.DELETEDATA(
   cd        IN     DOMCHARACTERDATA,
   offset    IN     NUMBER,
   cnt       IN     NUMBER);

パラメータ

表206-35 DELETEDATAプロシージャのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`offset`	データを削除するオフセット。
`cnt`	削除する(オフセット以降の)文字数。

206.7.15 FINDENTITYファンクション

このファンクションは、指定のDTDでエンティティを検索し、見つかった場合はそのエンティティを戻します。

参照:

構文

DBMS_XMLDOM.FINDENTITY(
   dt     IN     DOMDOCUMENTTYPE,
   name   IN     VARCHAR2,
   par    IN     BOOLEAN) 
 RETURN  DOMENTITY;

パラメータ

表206-36 FINDENTITYファンクションのパラメータ

パラメータ	説明
`dt`	DTD。
`name`	検索するエンティティ。
`par`	エンティティのタイプを示すフラグ。パラメータ・エンティティの場合は`TRUE`、通常のエンティティの場合は`FALSE`になります。

206.7.16 FINDNOTATIONファンクション

このファンクションは、指定のDTDで表記法を検索し、見つかった場合はその表記法を戻します。

参照:

構文

DBMS_XMLDOM.FINDNOTATION(
   dt        IN     DOMDocumentType,
   name      IN     VARCHAR2) 
 RETURN DOMNOTATION;

パラメータ

表206-37 FINDNOTATIONファンクションのパラメータ

パラメータ	説明
`dt`	DTD。
`name`	検索する表記法。

206.7.17 FREEDOCFRAGプロシージャ

このプロシージャは、指定したドキュメント・フラグメントを解放します。

参照:

DOMDocumentサブプログラムおよびDOMDocumentFragmentサブプログラム

構文

DBMS_XMLDOM.FREEDOCFRAG(
   df    IN    DOMDOCUMENTFRAGMENT);

パラメータ

表206-38 FREEDOCFRAGプロシージャのパラメータ

パラメータ	説明
`df`	DOMDocumentFragment

206.7.18 FREEDOCUMENTプロシージャ

このプロシージャは、DOMDOCUMENTオブジェクトを解放します。

参照:

DBMS_XMLDOM DOMElementサブプログラム

構文

DBMS_XMLDOM.FREEDOCUMENT(
   doc     IN     DOMDOCUMENT);

パラメータ

表206-39 FREEDOCUMENTプロシージャのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`

206.7.19 FREEELEMENTプロシージャ

このプロシージャは、DOMElementハンドルに割り当てられているメモリーを解放します。

参照:

構文

DBMS_XMLDOM.FREEELEMENT(
    elem IN DOMELEMENT);

パラメータ

表206-40 FREEELEMENTプロシージャのパラメータ

パラメータ	説明
elem	`DOMELEMENT`タイプ

206.7.20 FREENODEプロシージャ

このプロシージャは、DOMNODEに関連付けられたすべてのリソースを解放します。

参照:

DBMS_XMLDOM DOMNodeListサブプログラム

構文

DBMS_XMLDOM.FREENODE(
   n      IN     DOMNODE);

パラメータ

表206-41 FREENODEプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.21 FREENODELISTプロシージャ

このプロシージャは、ノード・リストに関連付けられたすべてのリソースを解放します。

参照:

構文

DBMS_XMLDOM.FREENODELIST(
   nl IN DOMNodeList);

パラメータ

表206-42 FREENODELISTプロシージャのパラメータ

パラメータ	説明
`nl`	`DOMNODELIST`タイプ

206.7.22 GETATTRIBUTEファンクション

このファンクションは、指定した名前のDOMELEMENTの属性値を戻します。

参照:

構文

指定した名前のDOMELEMENTの属性値を戻します。

DBMS_XMLDOM.GETATTRIBUTE(
   elem       IN      DOMELEMENT,
   name       IN      VARCHAR2)
 RETURN VARCHAR2;

指定した名前と名前空間URIのDOMELEMENTの属性値を戻します。

DBMS_XMLDOM.GETATTRIBUTE(
   elem      IN     DOMELEMENT,
   name      IN     VARCHAR2,
   ns        IN     VARCHAR2)
 RETURN VARCHAR2;

パラメータ

表206-43 GETATTRIBUTEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	属性名
`ns`	ネームスペース

206.7.23 GETATTRIBUTENODEファンクション

このファンクションは、指定した名前のDOMELEMENTの属性ノードを戻します。このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

参照:

構文

指定した名前のDOMELEMENTの属性ノードを戻します。

DBMS_XMLDOM.GETATTRIBUTENODE(
   elem      IN     DOMElement,
   name      IN     VARCHAR2)
 RETURN DOMATTR;

指定した名前と名前空間URIのDOMELEMENTの属性ノードを戻します。

DBMS_XMLDOM.GETATTRIBUTENODE(
   elem      IN     DOMElement,
   name      IN     VARCHAR2,
   ns        IN     VARCHAR2)
RETURN DOMATTR;

パラメータ

表206-44 GETATTRIBUTENODEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	属性名。ワイルドカード(*)を使用すると、すべての属性が指定されます。
`ns`	ネームスペース

206.7.24 GETATTRIBUTESファンクション

このファンクションは、指定したノードが要素の場合はその要素の属性を含むNAMEDNODEMAPを取得し、それ以外の場合はNULLになります。

参照:

構文

DBMS_XMLDOM.GETATTRIBUTES(
   n      IN      DOMNode)
 RETURN DOMNAMEDNODEMAP;

パラメータ

表206-45 GETATTRIBUTESファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.25 GETCHARSETファンクション

このファンクションは、DOM文書の文字セットを取得します。

参照:

構文

DBMS_XMLDOM.GETCHARSET(
   doc IN    DOMDocument)
 RETURN VARCHAR2;

パラメータ

表206-46 GETCHARSETファンクションのパラメータ

パラメータ	説明
doc	`DOM`文書

使用上のノート

新しく解析されたドキュメントについては、データベースの文字セットを戻します。charsetにNULL以外の値を指定してSETCHARSETプロシージャがコールされると、そのcharsetが戻されます。

206.7.26 GETCHILDNODESファンクション

このファンクションは、指定したノードのすべての子ノードを含むDOMNODELISTを取得します。子ノードが存在しない場合は、ノードを含まないDOMNODELISTになります。

参照:

構文

DBMS_XMLDOM.GETCHILDNODES(
   n      IN    DOMNode)
 RETURN DOMNodeList;

パラメータ

表206-47 GETCHILDNODESファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.27 GETCHILDRENBYTAGNAMEファンクション

このファンクションは、DOMELEMENTの子を戻します。

参照:

構文

タグ名を指定して、DOMELEMENTの子を戻します。

DBMS_XMLDOM.GETCHILDRENBYTAGNAME(
   elem      IN      DOMElement, 
   name      IN      VARCHAR2) 
 RETURN DOMNODELIST;

タグ名と名前空間を指定して、DOMELEMENTの子を戻します。

DBMS_XMLDOM.GETCHILDRENBYTAGNAME(
   elem      IN      DOMElement, 
   name      IN      VARCHAR2, 
   ns        IN      VARCHAR2) 
RETURN DOMNODELIST;

パラメータ

表206-48 GETCHILDRENBYTAGNAMEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	タグ名
`ns`	ネームスペース

206.7.28 GETDATAファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

インタフェースを実装するノードの文字データを取得します(関連項目: 「DOMCharacterDataサブプログラム」)。

DBMS_XMLDOM.GETDATA(
   cd      IN    DOMCHARACTERDATA)
 RETURN VARCHAR2;

DOMProcessingInstructionのコンテンツ・データを戻します(関連項目: 「DOMProcessingInstructionサブプログラム」)。

DBMS_XMLDOM.GETDATA(
   pi      IN    DOMPROCESSINGINSTRUCTION)
 RETURN VARCHAR2;

パラメータ

表206-49 GETDATAファンクションのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`pi`	`DOMPROCESSINGINSTRUCTION`

206.7.29 GETDOCTYPEファンクション

このファンクションは、DOMDOCUMENTに関連付けられたDTDを戻します。

参照:

構文

DBMS_XMLDOM.GETDOCTYPE(
   doc      IN     DOMDOCUMENT)
RETURN DOMDOCUMENTTYPE;

パラメータ

表206-50 GETDOCTYPEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`

206.7.30 GETDOCUMENTELEMENTファンクション

このファンクションは、DOMDOCUMENTのルート要素を戻します。

参照:

構文

DBMS_XMLDOM.GETDOCUMENTELEMENT(
   doc      IN      DOMDOCUMENT)
 RETURN DOMELEMENT;

パラメータ

表206-51 GETDOCUMENTELEMENTファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`

206.7.31 GETELEMENTSBYTAGNAMEファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

タグ名を指定して、すべての要素のDOMNODELISTを戻します(関連項目: 「DOMDocumentサブプログラム」)。

DBMS_XMLDOM.GETELEMENTSBYTAGNAME(
   doc         IN      DOMDOCUMENT,
   tagname     IN      VARCHAR2)
 RETURN DOMNODELIST;

タグ名を指定して、DOMELEMENTの要素の子を戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.GETELEMENTSBYTAGNAME(
   elem      IN     DOMELEMENT,
   name      IN     VARCHAR2) 
 RETURN DOMNODELIST;

タグ名と名前空間を指定して、DOMELEMENTの要素の子を戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.GETELEMENTSBYTAGNAME(
   elem      IN     DOMELEMENT,
   name      IN     VARCHAR2, 
   ns        IN     VARCHAR2) 
 RETURN DOMNODELIST;

パラメータ

表206-52 GETELEMENTSBYTAGNAMEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`tagname`	一致させるタグの名前。
`elem`	`DOMELEMENT`
`name`	タグ名。ワイルドカード(*)を使用すると、すべてのタグが指定されます。
`ns`	ネームスペース

206.7.32 GETENTITIESファンクション

このファンクションは、DTDで宣言された一般的なエンティティ(外部と内部の両方)を含むDOMNAMEDNODEMAPを取得します。

参照:

構文

DBMS_XMLDOM.GETENTITIES(
   dt      IN     DOMDocumentType)
 RETURN DOMNAMEDNODEMAP;

パラメータ

表206-53 GETENTITIESファンクションのパラメータ

パラメータ	説明
`dt`	`DOMDOCUMENTTYPE`

206.7.33 GETEXPANDEDNAMEプロシージャ/ファンクション

このサブプログラムは、1つのプロシージャおよび2つのファンクションとしてオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

NodeがElementタイプまたはAttributeタイプである場合は、そのノードの拡張名を取得し、それ以外の場合はNULLを戻します(関連項目: 「DOMNodeサブプログラム」)。

DBMS_XMLDOM.GETEXPANDEDNAME(
   n       IN      DOMNODE
   data    OUT     VARCHAR);

DOMAttrの拡張名を戻します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.GETEXPANDEDNAME(
   a       IN     DOMAttr)
 RETURN VARCHAR2;

DOMElementの拡張名を戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.GETEXPANDEDNAME(
   elem      IN    DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

表206-54 GETEXPANDEDNAMEプロシージャ/ファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`
`data`	戻される`Node`の拡張名。
`a`	`DOMATTR`
`elem`	`DOMELEMENT`

206.7.34 GETFIRSTCHILDファンクション

このファンクションは、ノードの最初の子を取得します。該当するノードがない場合は、NULLを戻します。

参照:

構文

DBMS_XMLDOM.GETFIRSTCHILD(
   n      IN      DOMNODE)
 RETURN DOMNODE;

パラメータ

表206-55 GETFIRSTCHILDファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.35 GETIMPLEMENTATIONファンクション

このファンクションは、指定したDOMDOCUMENTを処理するDOMIMPLEMENTATIONオブジェクトを戻します。

参照:

構文

DBMS_XMLDOM.GETIMPLEMENTATION(
   doc      IN     DOMDOCUMENT)
 RETURN DOMIMPLEMENTATION;

パラメータ

表206-56 GETIMPLEMENTATIONファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`

206.7.36 GETLASTCHILDファンクション

このファンクションは、ノードの最後の子を取得します。該当するノードがない場合は、NULLを戻します。

参照:

構文

DBMS_XMLDOM.GETLASTCHILD(
   n     IN   DOMNODE)
 RETURN DOMNODE;

パラメータ

表206-57 GETLASTCHILDファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.37 GETLENGTHファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

データの文字数を取得します。CharacterDataノードが空の場合は、ゼロが戻されます(関連項目: 「DOMCharacterDataサブプログラム」)。

DBMS_XMLDOM.GETLENGTH(
   cd     IN     DOMCHARACTERDATA)
 RETURN NUMBER;

指定したマップ内のノード数を取得します。子ノードの索引の有効範囲は、0以上かつlength-1以下です(関連項目: 「DOMNamedNodeMapサブプログラム」)。

DBMS_XMLDOM.GETLENGTH(
   nnm      IN     DOMNAMEDNODEMAP)
 RETURN NUMBER;

リスト内のノード数を取得します。子ノードの索引の有効範囲は、0以上かつlength-1以下です(関連項目: 「DOMNodeListサブプログラム」)。

DBMS_XMLDOM.GETLENGTH(
   nl     IN    DOMNODELIST)
 RETURN NUMBER;

パラメータ

表206-58 GETLENGTHファンクションのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`nnm`	`DOMNAMEDNODEMAP`
`nl`	`DOMNODELIST`

206.7.38 GETLOCALNAMEプロシージャ/ファンクション

このファンクションは、1つのプロシージャおよび2つのファンクションとしてオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

ノードの修飾名のうちローカル部分を取得します(関連項目: 「DOMNodeサブプログラム」)。

DBMS_XMLDOM.GETLOCALNAME(
   n       IN     DOMNODE,
   data    OUT    VARCHAR2);

DOMAttrのローカル名を戻します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.GETLOCALNAME(
   a       IN     DOMATTR)
 RETURN VARCHAR2;

DOMElementのローカル名を戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.GETLOCALNAME(
   elem       IN     DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

表206-59 GETLOCALNAMEプロシージャ/ファンクションのパラメータ

パラメータ	説明
`n`	`DOMNode`
`data`	戻されるローカル名。
`a`	`DOMAttr`。
`elem`	`DOMElement`。

206.7.39 GETNAMEファンクション

このファンクションはオーバーロードされています。機能の特定の形式は、構文宣言の箇所に併記してあります。

構文

属性の名前を戻します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.GETNAME(
   a       IN     DOMATTR)
 RETURN VARCHAR2;

DTDの名前、またはDOCTYPEキーワードの直後の名前を取得します(関連項目: 「DOMDocumentTypeサブプログラム」)。

DBMS_XMLDOM.GETNAME(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN VARCHAR2;

パラメータ

表206-60 GETNAMEファンクションのパラメータ

パラメータ	説明
`a`	`DOMATTR`
`dt`	`DOMDOCUMENTTYPE`

206.7.40 GETNAMEDITEMファンクション

GETNAMEDITEMは、指定された名前のノードを取得します。

参照:

DOMNamedNodeMapサブプログラム

構文

指定した名前のノードを取得します。

DBMS_XMLDOM.GETNAMEDITEM(
   nnm    IN  DOMNAMEDNODEMAP,
   name   IN  VARCHAR2)
 RETURN DOMNODE;

指定した名前と名前空間URIのノードを取得します。

DBMS_XMLDOM.GETNAMEDITEM(
   nnm    IN  DOMNAMEDNODEMAP,
   name   IN  VARCHAR2,
   ns     IN  VARCHAR2)
 RETURN DOMNODE;

パラメータ

表206-61 GETNAMEDITEMファンクションのパラメータ

パラメータ	説明
`nnm`	`DOMNAMEDNODEMAP`
`name`	取得する項目の名前。
`ns`	ネームスペース

206.7.41 GETNAMESPACEプロシージャ/ファンクション

構文

ノードに関連付けられた名前空間URIを取得します(関連項目: 「DOMNodeサブプログラム」)。

DBMS_XMLDOM.GETNAMESPACE(
   n       IN     DOMNODE,
   data    OUT    VARCHAR2);

DOMATTRの名前空間を取得します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.GETNAMESPACE(
   a       IN     DOMATTR)
 RETURN VARCHAR2;

DOMELEMENTの名前空間を取得します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.GETNAMESPACE(
   elem       IN     DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

表206-62 GETNAMESPACEプロシージャ/ファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`
`data`	戻される名前空間URI
`a`	`DOMATTR`
`elem`	`DOMELEMENT`

206.7.42 GETNEXTSIBLINGファンクション

このファンクションは、指定したノードの直後に続くノードを取得します。該当するノードがない場合は、NULLを戻します。

参照:

構文

DBMS_XMLDOM.GETNEXTSIBLING(
   n       IN     DOMNODE)
 RETURN DOMNode;

パラメータ

表206-63 GETNEXTSIBLINGファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.43 GETNODETYPEファンクション

このファンクションは、ノードの基礎となるオブジェクトのタイプを表すコードを取得します。

参照:

構文

DBMS_XMLDOM.GETNODETYPE(
   n       IN     DOMNODE)
 RETURN NUMBER;

パラメータ

表206-64 GETNODETYPEファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.44 GETNODENAMEファンクション

このファンクションは、ノードのタイプに応じてノード名を取得します。

参照:

構文

DBMS_XMLDOM.GETNODENAME(
   n       IN     DOMNODE)
 RETURN VARCHAR2;

パラメータ

表206-65 GETNODENAMEファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.45 GETNODEVALUEファンクション

このファンクションは、ノードのタイプに応じてノードの値を取得します。

参照:

構文

DBMS_XMLDOM.GETNODEVALUE(
   n       IN     DOMNODE)
 RETURN VARCHAR2;*

パラメータ

表206-66 GETNODEVALUEファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.46 GETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャ

これらのサブプログラムの操作は、各構文の実装で説明されています。

参照:

構文

このファンクションは、PL/SQL XMLBinaryInputStreamのインスタンスを戻します。ノードのデータ・タイプは、RAWまたはBLOBである必要があり、それ以外の場合は、例外が発生します。

DBMS_XMLDOM.GETNODEVALUEASBINARYSTREAM (
   n      IN     DOMNODE)
 RETURN SYS.UTL_BINARYINPUTSTREAM;

このプロシージャを使用して、アプリケーションは、XDBがノードの内容を書き込むSYS.UTL_BINARYOUTPUTSTREAMの実装を渡します。ノードのデータ・タイプは、RAWまたはCLOBである必要があり、それ以外の場合は、例外が発生します。

DBMS_XMLDOM.GETNODEVALUEASBINARYSTREAM (
   n        in   DOMNODE, 
   value    in   SYS.UTL_BINARYOUTPUTSTREAM);

パラメータ

表206-67 GETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNODE`
value	`BINARYOUTPUTSTREAM`

206.7.47 GETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャ

これらのサブプログラムの操作は、各構文の実装で説明されています。

参照:

構文

このファンクションは、PL/SQL XMLCharacterInputStreamのインスタンスを戻します。ノード・データが文字の場合は、現行セッションの文字セットに変換されます。ノード・データが文字データでない場合は、最初に文字データに変換されます。

DBMS_XMLDOM.GETNODEVALUEASCHARACTERSTREAM  (
   n        IN     DOMNODE)
 RETURN SYS.UTL_CHARACTERINPUTSTREAM;

このプロシージャを使用して、ノード・データは必要に応じてセッションの文字セットに変換され、次にSYS.UTL_CHARACTEROUTPUTSTREAMに送信されます。

DBMS_XMLDOM.GETNODEVALUEASCHARACTERSTREAM  (
   n        IN   DOMNODE,
   value    IN   SYS.UTL_CHARACTEROUTPUTSTREAM);

パラメータ

表206-68 GETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNODE`
value	`CHARACTEROUTPUTSTREAM`

206.7.48 GETNOTATIONNAMEファンクション

このファンクションは、DOMENTITYの表記法の名前を戻します。

参照:

DOMEntityサブプログラム

構文

DBMS_XMLDOM.GETNOTATIONNAME(
   ent       IN     DOMENTITY)
 RETURN VARCHAR2;

パラメータ

表206-69 GETNOTATIONNAMEファンクションのパラメータ

パラメータ	説明
`ent`	`DOMENTITY`

206.7.49 GETNOTATIONSファンクション

このファンクションは、DTDで宣言された表記法を含むDOMNAMEDNODEMAPを取得します。

参照:

DOMProcessingInstructionサブプログラム

構文

DBMS_XMLDOM.GETNOTATIONS(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN DOMNAMEDNODEMAP;

パラメータ

表206-70 GETNOTATIONSファンクションのパラメータ

パラメータ	説明
`dt`	`DOMDOCUMENTTYPE`

206.7.50 GETTARGETファンクション

このファンクションは、DOMPROCESSINGINSTRUCTIONのターゲットを戻します。

参照:

構文

DBMS_XMLDOM.GETTARGET(
   pi       IN     DOMPROCESSINGINSTRUCTION)
 RETURN VARCHAR2;

パラメータ

表206-71 GETTARGETファンクションのパラメータ

パラメータ	説明
`pi`	`DOMPROCESSINGINSTRUCTION`

206.7.51 GETOWNERDOCUMENTファンクション

このファンクションは、指定したノードに関連付けられたドキュメント・オブジェクトを取得します。このドキュメント・オブジェクトは、新規ノードの作成にも使用されます。指定したノードがドキュメントによってまだ使用されていないドキュメント・タイプまたはドキュメントの場合は、NULLが戻されます。

参照:

構文

DBMS_XMLDOM.GETOWNERDOCUMENT(
   n       IN     DOMNODE)
 RETURN DOMDOCUMENT;

パラメータ

表206-72 GETOWNERDOCUMENTファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.52 GETOWNERELEMENTファンクション

このファンクションは、指定した属性が接続される要素ノードを取得します。

参照:

構文

DBMS_XMLDOM.GETOWNERELEMENT(
   a       IN     DOMATTR)
 RETURN DOMElement;

パラメータ

表206-73 GETOWNERELEMENTファンクションのパラメータ

パラメータ	説明
`a`	属性

206.7.53 GETPARENTNODEファンクション

このファンクションは、指定したノードの親を取得します。Attr、Document、DocumentFragment、Entity、およびNotationを除くすべてのノードは、親ノードを持つ可能性があります。ただし、作成したノードがツリーに追加されていない場合、またはノードがツリーから削除された場合は、NULLが戻されます。

参照:

構文

DBMS_XMLDOM.GETPARENTNODE(
   n       IN     DOMNODE)
 RETURN DOMNODE;

パラメータ

表206-74 GETPARENTNODEファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.54 GETPREFIXファンクション

このファンクションは、ノードの名前空間の接頭辞を取得します。

参照:

構文

DBMS_XMLDOM.GETPREFIX(
   n       IN     DOMNODE)
 RETURN VARCHAR2;

パラメータ

表206-75 GETPREFIXファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.55 GETPREVIOUSSIBLINGファンクション

このファンクションは、指定したノードの直前にあるノードを取得します。該当するノードがない場合は、NULLを戻します。

参照:

構文

DBMS_XMLDOM.GETPREVIOUSSIBLING(
   n       IN     DOMNODE)
 RETURN DOMNODE;

パラメータ

表206-76 GETPREVIOUSSIBLINGファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.56 GETPUBLICIDファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

指定したDTDの公開識別子を戻します(関連項目: 「DOMDocumentTypeサブプログラム」)。

DBMS_XMLDOM.GETPUBLICID(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN VARCHAR2;

DOMENTITYの公開識別子を戻します(関連項目: 「DOMEntityサブプログラム」)。

DBMS_XMLDOM.GETPUBLICID(
   ent      IN     DOMENTITY)
 RETURN VARCHAR2;

DOMNOTATIONの公開識別子を戻します(関連項目: 「DOMNotationサブプログラム」)。

DBMS_XMLDOM.GETPUBLICID(
   n        IN     DOMNOTATION)
 RETURN VARCHAR2;

パラメータ

表206-77 GETPUBLICIDファンクションのパラメータ

パラメータ	説明
`dt`	DTD。
`ent`	`DOMENTITY`
`n`	`DOMNOTATION`

206.7.57 GETQUALIFIEDNAMEファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

DOMATTRの修飾名を戻します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.GETQUALIFIEDNAME(
   a        IN     DOMATTR)
 RETURN VARCHAR2;

DOMElementの修飾名を戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.GETQUALIFIEDNAME(
   elem     IN     DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

表206-78 GETQUALIFIEDNAMEファンクションのパラメータ

パラメータ	説明
`a`	`DOMATTR`
`elem`	`DOMELEMENT`

206.7.58 GETSCHEMANODEファンクション

このファンクションは、ノードに関連付けられたスキーマURIを取得します。

参照:

構文

DBMS_XMLDOM.GETSCHEMANODE(
   n       IN     DOMNODE)
 RETURN DOMNODE;

パラメータ

表206-79 GETSCHEMANODEファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.59 GETSPECIFIEDファンクション

元のドキュメントで属性の値が明示的に指定されている場合はTRUE、それ以外の場合はFALSEを戻します。

参照:

構文

DBMS_XMLDOM.GETSPECIFIED(
   a       IN     DOMATTR)
 RETURN BOOLEAN;

パラメータ

表206-80 GETSPECIFIEDファンクションのパラメータ

パラメータ	説明
`a`	`DOMATTR`

206.7.60 GETSTANDALONEファンクション

このファンクションは、DOMDOCUMENTに関連付けられたスタンドアロン・プロパティを戻します。

参照:

構文

DBMS_XMLDOM.GETSTANDALONE(
   doc       IN     DOMDOCUMENT)
 RETURN VARCHAR2;

パラメータ

表206-81 GETSTANDALONEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`。

206.7.61 GETSYSTEMIDファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

指定したDTDのシステム識別子を戻します(関連項目: 「DOMDocumentTypeサブプログラム」)。

DBMS_XMLDOM.GETSYSTEMID(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN VARCHAR2;

DOMENTITYのシステム識別子を戻します(関連項目: 「DOMEntityサブプログラム」)。

DBMS_XMLDOM.GETSYSTEMID(
   ent      IN     DOMENTITY)
 RETURN VARCHAR2;

DOMNOTATIONのシステム識別子を戻します(関連項目: 「DOMNotationサブプログラム」)。

DBMS_XMLDOM.GETSYSTEMID(
   n        IN     DOMNOTATION)
 RETURN VARCHAR2;

パラメータ

表206-82 GETSYSTEMIDファンクションのパラメータ

パラメータ	説明
`dt`	DTD。
`ent`	`DOMEntity`。
`n`	`DOMNotation`。

206.7.62 GETTAGNAMEファンクション

このファンクションは、DOMELEMENTの名前を戻します。

参照:

構文

DBMS_XMLDOM.GETTAGNAME(
   elem       IN     DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

表206-83 GETTAGNAMEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`

206.7.63 GETVALUEファンクション

このファンクションは、属性の値を取得します。

参照:

構文

DBMS_XMLDOM.GETVALUE(
   a       IN     DOMATTR)
 RETURN VARCHAR2;

パラメータ

表206-84 GETVALUEファンクションのパラメータ

パラメータ	説明
`a`	`DOMATTR`

206.7.64 GETVERSIONファンクション

このファンクションは、DOMDOCUMENTのバージョンを戻します。

参照:

構文

DBMS_XMLDOM.GETVERSION(
   doc       IN     DOMDOCUMENT)
 RETURN VARCHAR2;

パラメータ

表206-85 GETVERSIONファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`

206.7.65 GETXMLTYPEファンクション

このファンクションは、DOMDOCUMENTに関連付けられたXMLTypeを戻します。

参照:

構文

DBMS_XMLDOM.GETXMLTYPE(
   doc       IN     DOMDOCUMENT)
 RETURN SYS.XMLTYPE;

パラメータ

表206-86 GETXMLTYPEファンクションのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`

206.7.66 HASATTRIBUTEファンクション

指定した属性がDOMELEMENTで定義されているかどうか、またはデフォルト値が存在するかどうかをテストします。

参照:

構文

指定した名前を持つ属性がDOMElementで定義されているかどうかをテストします。

DBMS_XMLDOM.HASATTRIBUTE(
   elem     IN  DOMELEMENT,
   name     IN  VARCHAR2)
 RETURN VARCHAR2;

指定した名前と名前空間URIを持つ属性がDOMELEMENTで定義されているかどうかをテストし、名前空間を有効にします。

DBMS_XMLDOM.HASATTRIBUTE(
   elem     IN  DOMELEMENT,
   name     IN  VARCHAR2,
   ns       IN  VARCHAR2)
 RETURN VARCHAR2;

パラメータ

表206-87 HASATTRIBUTEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	属性名。ワイルドカード(*)を使用すると、すべての属性が指定されます。
`ns`	ネームスペース

206.7.67 HASATTRIBUTESファンクション

このファンクションは、ノードに属性が存在するかどうかをテストします。

参照:

構文

DBMS_XMLDOM.HASATTRIBUTES(
   n       IN     DOMNODE)
 RETURN BOOLEAN;

パラメータ

表206-88 HASATTRIBUTESファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.68 HASCHILDNODESファンクション

このファンクションは、ノードに子ノードが存在するかどうかをテストします。

参照:

構文

DBMS_XMLDOM.HASCHILDNODES(
   n       IN     DOMNODE)
 RETURN BOOLEAN;

パラメータ

表206-89 HASCHILDNODESファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`

206.7.69 HASFEATUREファンクション

このファンクションは、DOMIMPLEMENTATIONで特定の機能が実装されているかどうかをテストします。

参照:

DOMImplementationサブプログラム

構文

DBMS_XMLDOM.HASFEATURE(
   di       IN     DOMIMPLEMENTATION,
   feature  IN     VARCHAR2,
   version  IN     VARCHAR2)
 RETURN BOOLEAN;

パラメータ

表206-90 HASFEATUREファンクションのパラメータ

パラメータ	説明
`di`	`DOMIMPLEMENTATION`
`feature`	チェックする機能。
`version`	チェックするDOMのバージョン。

206.7.70 IMPORTNODEファンクション

このファンクションは外部のドキュメントからノードをインポートして、その新規ノードを戻します。

参照:

構文

DBMS_XMLDOM.IMPORTNODE(
   doc            IN  DOMDOCUMENT,
   importedNode   IN  DOMNODE,
   deep           IN  BOOLEAN)
  RETURN DOMNODE;

パラメータ

表206-91 IMPORTNODEファンクションのパラメータ

パラメータ説明

doc

ノードをインポートする元のドキュメント。

importedNode

インポートするノード。

deep

再帰的インポートに関する設定。

この値をTRUEに設定すると、指定したノードとともに、そのノードのサブツリー全体がインポートされます。
この値をFALSEに設定すると、指定したノードのみがインポートされます。

使用上のノート

206.7.71 INSERTBEFOREファンクション

このファンクションは、ノードnewchildを、既存の子ノードrefchildの前に挿入します。refchildがNULLの場合、newchildは子リストの最後に挿入されます。

newchildがDOCUMENTFRAGMENTオブジェクトの場合は、newchildのすべての子が同じ順序でrefchild.の前に挿入されます。newchildがすでにツリーに追加されている場合は、そのノードが最初に削除されます。

参照:

構文

DBMS_XMLDOM.INSERTBEFORE(
   n          IN     DOMNODE,
   newchild   IN     DOMNODE,
   refchild   IN     DOMNODE)
  RETURN DOMNode;

パラメータ

表206-92 INSERTBEFOREファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`
`newChild`	`DOMNODE`に挿入される子。
`refChild`	`newchild`が挿入される直前の参照ノード。

206.7.72 INSERTDATAプロシージャ

このプロシージャは、文字数単位で指定されたオフセット位置に文字列データを挿入します。

参照:

構文

DBMS_XMLDOM.INSERTDATA(
   cd       IN     DOMCHARACTERDATA,
   offset   IN     NUMBER,
   arg      IN     VARCHAR2);

パラメータ

表206-93 INSERTDATAプロシージャのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`offset`	データを挿入するオフセット。
`arg`	挿入する値。

206.7.73 ISNULLファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

指定したDOMNODEがNULLかどうかをチェックします。NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMNodeサブプログラム」)。

DBMS_XMLDOM.ISNULL(
  n        IN     DOMNODE) 
 RETURN BOOLEAN;

指定したDOMATTRがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   a       IN     DOMATTR)
 RETURN BOOLEAN;

指定したDOMCDATASECTIONがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMCDataSectionサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   cds      IN     DOMCDATASECTION)
 RETURN BOOLEAN;

指定したDOMCHARACTERDATAがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMCharacterDataサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   cd       IN     DOMCHARACTERDATA)
 RETURN BOOLEAN;

指定したDOMCOMMENTがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMCommentサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   com       IN     DOMCOMMENT)
 RETURN BOOLEAN;

指定したDOMDOCUMENTがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMDocumentサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   doc       IN     DOMDOCUMENT)
 RETURN BOOLEAN;

指定したDOMDOCUMENTFRAGMENTがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMDocumentFragmentサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   df       IN     DOMDOCUMENTFRAGMENT)
 RETURN BOOLEAN;

指定したDOMDOCUMENTTYPEがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMDocumentTypeサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN BOOLEAN;

指定したDOMELEMENTがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   elem     IN     DOMELEMENT)
 RETURN BOOLEAN;

指定したDOMENTITYがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMEntityサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   ent       IN     DOMENTITY)
 RETURN BOOLEAN;

指定したDOMENTITYREFERENCEがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMEntityReferenceサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   EREF       IN     DOMENTITYREFERENCE)
 RETURN BOOLEAN;

指定したDOMIMPLEMENTATIONがNULLかどうかをチェックし、NULLの場合はTRUEを戻します(関連項目: 「DOMImplementationサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   di       IN     DOMIMPLEMENTATION)
 RETURN BOOLEAN;

指定したDOMNAMEDNODEMAPがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMNamedNodeMapサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   nnm       IN     DOMNAMEDNODEMAP)
 RETURN BOOLEAN;

指定したDOMNODELISTがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMNodeListサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   nl       IN     DOMNODELIST)
 RETURN BOOLEAN;

指定したDOMNOTATIONがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMNotationサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   n       IN     DOMNOTATION)
 RETURN BOOLEAN;

指定したDOMPROCESSINGINSTRUCTIONがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMProcessingInstructionサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   pi       IN     DOMPROCESSINGINSTRUCTION)
 RETURN BOOLEAN;

指定したDOMTEXTがNULLかどうかをチェックし、NULLの場合はTRUEを、それ以外の場合はFALSEを戻します(関連項目: 「DOMTextサブプログラム」)。

DBMS_XMLDOM.ISNULL(
   t       IN     DOMTEXT)
 RETURN BOOLEAN;

パラメータ

表206-94 ISNULLファンクションのパラメータ

パラメータ	説明
`n`	チェックする`DOMNODE`
`a`	チェックする`DOMATTR`
`cds`	チェックする`DOMCDATASECTION`
`cd`	チェックする`DOMCHARACTERDATA`
`com`	チェックする`DOMCOMMENT`
`doc`	チェックする`DOMDOCUMENT`
`dF`	チェックする`DOMDOCUMENTFRAGMENT`
`dt`	チェックする`DOMDOCUMENTTYPE`
`elem`	チェックする`DOMELEMENT`
`ent`	チェックする`DOMENTITY`
`eref`	チェックする`DOMENTITYREFERENCE`
`di`	チェックする`DOMIMPLEMENTATION`
`nnm`	チェックする`DOMNAMENODEMAP`
`nl`	チェックする`DOMNODELIST`
`n`	チェックする`DOMNOTATION`
`pi`	チェックする`DOMPROCESSINGINSTRUCTION`
`t`	チェックする`DOMTEXT`

206.7.74 ITEMファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

マップ内の項目のうち、指定した索引(INDEXパラメータ)に対応する項目を戻します。索引(INDEX)の値がマップ内のノード数以上の場合は、NULLを戻します(関連項目: 「DOMNamedNodeMapサブプログラム」)。

DBMS_XMLDOM.ITEM(
   nnm       IN     DOMNAMEDNODEMAP,
   index     IN     NUMBER)
 RETURN DOMNODE;

ノード・リスト内の項目のうち、指定した索引(INDEXパラメータ)に対応する項目を戻します。索引(INDEX)の値がノード・リスト内のノード数以上の場合は、NULLを戻します(関連項目: 「DOMNodeListサブプログラム」)。

DBMS_XMLDOM.ITEM(
   nl       IN     DOMNODELIST,
   index    IN     NUMBER)
 RETURN DOMNODE;

パラメータ

表206-95 ITEMファンクションのパラメータ

パラメータ	説明
`nnm`	`DOMNAMEDNODEMAP`
`index`	ノード・マップ内の索引のうち、取得する項目が存在する位置の索引。
`nl`	`DOMNODELIST`
`index`	`NodeList`内の索引のうち、取得する項目が存在する位置の索引

206.7.75 MAKEATTRファンクション

このファンクションは、指定したDOMNODEをDOMATTRに変換し、そのDOMATTRを戻します。

参照:

構文

DBMS_XMLDOM.MAKEATTR(
   n       IN     DOMNODE)
 RETURN DOMATTR;

パラメータ

表206-96 MAKEATTRファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.76 MAKECDATASECTIONファンクション

このファンクションは、指定したDOMNODEをDOMCDATASECTIONに変換します。

参照:

構文

DBMS_XMLDOM.MAKECDATASECTION(
   n       IN     DOMNODE)
 RETURN DOMCDATASECTION;

パラメータ

表206-97 MAKECDATASECTIONファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.77 MAKECHARACTERDATAファンクション

このファンクションは、指定したDOMNODEをDOMCHARACTERDATAに変換し、そのDOMCHARACTERDATAを戻します。

参照:

構文

DBMS_XMLDOM.MAKECHARACTERDATA(
   n       IN     DOMNode)
 RETURN DOMCharacterData;

パラメータ

表206-98 MAKECHARACTERDATAファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.78 MAKECOMMENTファンクション

このファンクションは、指定したDOMNODEをDOMCOMMENTに変換し、そのDOMCOMMENTを戻します。

参照:

構文

DBMS_XMLDOM.MAKECOMMENT(
   n       IN     DOMNODE)
 RETURN DOMCOMMENT;

パラメータ

表206-99 MAKECOMMENTファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.79 MAKEDOCUMENTファンクション

このファンクションは、指定したDOMNODEをDOMDOCUMENTに変換し、そのDOMDOCUMENTを戻します。

参照:

構文

DBMS_XMLDOM.MAKEDOCUMENT(
   n       IN     DOMNODE)
 RETURN DOMDocument;

パラメータ

表206-100 MAKEDOCUMENTファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.80 MAKEDOCUMENTFRAGMENTファンクション

このファンクションは、指定したDOMNODEをDOMDOCUMENTFRAGMENTに変換し、そのDOMDOCUMENTFRAGMENTを戻します。

参照:

構文

DBMS_XMLDOM.MAKEDOCUMENTFRAGMENT(
   n       IN     DOMNODE)
 RETURN DOMDOCUMENTFRAGMENT;

パラメータ

表206-101 MAKEDOCUMENTFRAGMENTファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.81 MAKEDOCUMENTTYPEファンクション

このファンクションは、指定したDOMNODEをDOMDOCUMENTTYPEに変換し、そのDOMDOCUMENTTYPEを戻します。

参照:

構文

DBMS_XMLDOM.MAKEDOCUMENTTYPE(
   n       IN     DOMNODE)
 RETURN DOMDOCUMENTTYPE;

パラメータ

表206-102 MAKEDOCUMENTTYPEファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.82 MAKEELEMENTファンクション

このファンクションは、指定したDOMNODEをDOMELEMENTに変換し、そのDOMELEMENTを戻します。

参照:

構文

DBMS_XMLDOM.MAKEELEMENT(
   n       IN     DOMNODE)
 RETURN DOMELEMENT;

パラメータ

表206-103 MAKEELEMENTファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.83 MAKEENTITYファンクション

このファンクションは、指定したDOMNODEをDOMENTITYに変換し、そのDOMENTITYを戻します。

参照:

構文

DBMS_XMLDOM.MAKEENTITY(
   n       IN     DOMNODE)
 RETURN DOMENTITY;

パラメータ

表206-104 MAKEENTITYファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.84 MAKEENTITYREFERENCEファンクション

このファンクションは、指定したDOMNODEをDOMENTITYREFERENCEに変換し、そのDOMENTITYREFERENCEを戻します。

参照:

構文

DBMS_XMLDOM.MAKEENTITYREFERENCE(
   n       IN     DOMNODE)
 RETURN DOMENTITYREFERENCE;

パラメータ

表206-105 MAKEENTITYREFERENCEファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.85 MAKENODEファンクション

このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。

構文

指定したDOMATTRをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMAttrサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   a        IN     DOMATTR)
 RETURN DOMNODE;

指定したDOMCDATASECTIONをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMCDataSectionサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   cds      IN     DOMCDATASECTION)
 RETURN DOMNODE;

指定したDOMCHARACTERDATAをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMCharacterDataサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   cd       IN     DOMCHARACTERDATA)
 RETURN DOMNODE;

指定したDOMCOMMENTをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMCommentサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   com      IN     DOMCOMMENT)
 RETURN DOMNODE;

指定したDOMDOCUMENTをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMDocumentサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   doc      IN     DOMDOCUMENT)
 RETURN DOMNODE;

指定したDOMDOCUMENTFRAGMENTをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMDocumentFragmentサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   df       IN     DOMDOCUMENTFRAGMENT)
 RETURN DOMNode;

指定したDOMDOCUMENTTYPEをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMDocumentTypeサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN DOMNODE;

指定したDOMELEMENTをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMElementサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   elem       IN     DOMELEMENT)
 RETURN DOMNODE;

指定したDOMENTITYをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMEntityサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   ent       IN     DOMENTITY)
 RETURN DOMNODE;

指定したDOMENTITYREFERENCEをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMEntityReferenceサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   eref       IN     DOMENTITYREFERENCE)
 RETURN DOMNODE;

指定したDOMNOTATIONをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMNotationサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   n       IN     DOMNOTATION)
 RETURN DOMNODE;

指定したDOMPROCESSINGINSTRUCTIONをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMProcessingInstructionサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   pi       IN     DOMPROCESSINGINSTRUCTION)
 RETURN DOMNODE;

指定したDOMTEXTをDOMNODEに変換し、そのDOMNODEを戻します(関連項目: 「DOMTextサブプログラム」)。

DBMS_XMLDOM.MAKENODE(
   t       IN     DOMTEXT)
 RETURN DOMNODE;

パラメータ

表206-106 MAKENODEファンクションのパラメータ

パラメータ	説明
`a`	変換する`DOMATTR`
`cds`	変換する`DOMCDATASECTION`
`cd`	変換する`DOMCHARACTERDATA`
`com`	変換する`DOMCOMMENT`
`doc`	変換する`DOMDOCUMENT`
`df`	変換する`DOMDOCUMENTFRAGMENT`
`dt`	変換する`DOMDOCUMENTTYPE`
`elem`	変換する`DOMELEMENT`
`ent`	変換する`DOMENTITY`
`eref`	変換する`DOMENTITYREFERENCE`
`n`	変換する`DOMNOTATION`
`pi`	変換する`DOMPROCESSINGINSTRUCTION`
t	変換する`DOMTEXT`

206.7.86 MAKENOTATIONファンクション

このファンクションは、指定したDOMNODEをDOMNOTATIONに変換し、そのDOMNOTATIONを戻します。

参照:

構文

DBMS_XMLDOM.MAKENOTATION(
   n       IN     DOMNODE)
 RETURN DOMNOTATION;

パラメータ

表206-107 MAKENOTATIONファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.87 MAKEPROCESSINGINSTRUCTIONファンクション

このファンクションは、指定したDOMNODEをDOMPROCESSINGINSTRUCTIONに変換し、そのDomprocessinginstructionを戻します。

参照:

構文

DBMS_XMLDOM.MAKEPROCESSINGINSTRUCTION(
   n       IN     DOMNODE)
 RETURN DOMPROCESSINGINSTRUCTION;

パラメータ

表206-108 MAKEPROCESSINGINSTRUCTIONファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.88 MAKETEXTファンクション

このファンクションは、指定したDOMNODEをDOMTEXTに変換し、そのDOMTEXTを戻します。

参照:

構文

DBMS_XMLDOM.MAKETEXT(
   n       IN     DOMNODE)
 RETURN DOMTEXT;

パラメータ

表206-109 MAKETEXTファンクションのパラメータ

パラメータ	説明
`n`	変換する`DOMNODE`

206.7.89 NEWDOMDOCUMENTファンクション

このファンクションは、新規のDOMDOCUMENTインスタンスを戻します。

参照:

構文

新規のDOMDOCUMENTインスタンスを戻します。

DBMS_XMLDOM.NEWDOMDOCUMENT
 RETURN DOMDOCUMENT;

指定したXMLTypeオブジェクトから作成された新規のDOMDOCUMENTインスタンスを戻します。

DBMS_XMLDOM.NEWDOMDOCUMENT(
   xmldoc    IN SYS.XMLTYPE)
 RETURN DOMDOCUMENT;

指定したCLOBから作成された新規のDOMDOCUMENTインスタンスを戻します。

DBMS_XMLDOM.NEWDOMDOCUMENT(
   cl       IN    CLOB)
 RETURN DOMDOCUMENT;

パラメータ

表206-110 NEWDOMDOCUMENTファンクションのパラメータ

パラメータ	説明
`xmldoc`	`DOMDOCUMENT`を作成するための`XMLType`ソース。
`cl`	`DOMDOCUMENT`を作成するための`CLOB`ソース。

206.7.90 NORMALIZEプロシージャ

このプロシージャは、DOMELEMENTのテキストの子を正規化します。

参照:

構文

DBMS_XMLDOM.NORMALIZE(
   elem       IN     DOMELEMENT);

パラメータ

表206-111 NORMALIZEプロシージャのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`

206.7.91 REMOVEATTRIBUTEプロシージャ

このプロシージャは、指定した名前の属性をDOMELEMENTから削除します。

参照:

構文

指定した名前のDOMELEMENTの属性値を削除します。

DBMS_XMLDOM.REMOVEATTRIBUTE(
   elem     IN    DOMELEMENT,
   name     IN    VARCHAR2);

指定した名前と名前空間URIのDOMELEMENTの属性値を削除します。

DBMS_XMLDOM.REMOVEATTRIBUTE(
   elem     IN    DOMELEMENT,
   name     IN    VARCHAR2,
   ns       IN    VARCHAR2);

パラメータ

表206-112 REMOVEATTRIBUTEプロシージャのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	属性名
`ns`	ネームスペース

206.7.92 REMOVEATTRIBUTENODEファンクション

このファンクションは、指定した属性ノードをDOMELEMENTから削除します。削除された属性ノードを戻します。

参照:

構文

DBMS_XMLDOM.REMOVEATTRIBUTENODE(
   elem       IN     DOMELEMENT,
   oldAttr    IN     DOMATTR)
  RETURN DOMAttr;

パラメータ

表206-113 REMOVEATTRIBUTENODEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`。
`oldAttr`	削除する`DOMATTR`。

206.7.93 REMOVECHILDファンクション

このファンクションは、oldchildパラメータで指定される子ノードを子ノード・リストから削除し、その子ノードを戻します。

参照:

構文

DBMS_XMLDOM.REMOVECHILD(
   n          IN     DOMNode,
   oldchild   IN     DOMNode)
 RETURN DOMNODE;

パラメータ

表206-114 REMOVECHILDファンクションのパラメータ

パラメータ	説明
`n`	`DOMNODE`
`oldCHild`	削除されるノード`n`の子ノード。

206.7.94 REMOVENAMEDITEMファンクション

このファンクションは、指定した名前のノードをマップから削除し、そのノードを戻します。

このマップに要素に追加された属性が含まれているとき、削除された属性にデフォルト値があるならば、名前空間URI、ローカル名、接頭辞(適切な場合)のほかにデフォルト値を持つ新しい属性が即座に作成されます。

参照:

DOMNamedNodeMapサブプログラム

構文

指定した名前のノードを削除します。

DBMS_XMLDOM.REMOVENAMEDITEM(
   nnm      IN     DOMNamedNodeMap,
   name     IN     VARCHAR2)
 RETURN DOMNode;

指定した名前と名前空間URIのノードを削除します。

DBMS_XMLDOM.REMOVENAMEDITEM(
   nnm      IN     DOMNamedNodeMap,
   name     IN     VARCHAR2,
   ns       IN     VARCHAR2)
 RETURN DOMNode;

パラメータ

表206-115 REMOVENAMEDITEMファンクションのパラメータ

パラメータ	説明
`nnm`	`DOMNamedNodeMap`
`name`	マップから削除する項目の名前。
`ns`	ネームスペース

206.7.95 REPLACECHILDファンクション

このファンクションは、子ノード・リスト内において、既存の子ノードoldchildを新しい子ノードnewchildで置き換え、そのoldchildノードを戻します。

newchildがDocumentFragmentオブジェクトの場合、oldchildは、DocumentFragmentのすべての子ノードで置き換えられます(これらの子ノードは、DocumentFragment内と同じ順序で挿入されます)。newchildがすでにツリーに追加されている場合は、そのノードが最初に削除されます。

参照:

構文

DBMS_XMLDOM.REPLACECHILD(
   n           IN     DOMNode,
   newchild    IN     DOMNode,
   oldchild    IN     DOMNode)
 RETURN DOMNode;

パラメータ

表206-116 REPLACECHILDファンクションのパラメータ

パラメータ	説明
`n`	`DOMNode`
`newchild`	既存の子ノードを置き換える新規の子ノード。
`oldchild`	新規の子ノードで置き換えられるノードnの子ノード。

206.7.96 REPLACEDATAプロシージャ

このプロシージャは、ノード内の特定範囲の文字列を新しい文字列で置き換えます。正常に削除されると、データと長さに変更が反映されます。

参照:

構文

DBMS_XMLDOM.REPLACEDATA(
   cd        IN     DOMCHARACTERDATA,
   offset    IN     NUMBER,
   cnt       IN     NUMBER,
   arg       IN     VARCHAR2);

パラメータ

表206-117 REPLACEDATAプロシージャのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`offset`	置換するオフセット。
`cnt`	置換する文字数。
`arg`	置換に使用する新しい値。

206.7.97 RESOLVENAMESPACEPREFIXファンクション

このファンクションは、指定した名前空間の接頭辞を解決し、解決済の名前空間を戻します。

参照:

構文

DBMS_XMLDOM.RESOLVENAMESPACEPREFIX(
   elem       IN     DOMELEMENT,
   prefix     IN     VARCHAR2) 
 RETURN VARCHAR2;

パラメータ

表206-118 RESOLVENAMESPACEPREFIXファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`prefix`	名前空間接頭辞

206.7.98 SETATTRIBUTEプロシージャ

このプロシージャは、DOMELEMENT属性の値を名前別に設定します。

参照:

構文

指定した名前のDOMELEMENTの属性値を設定します。

DBMS_XMLDOM.SETATTRIBUTE(
   elem       IN  DOMELEMENT,
   name       IN  VARCHAR2,
   newvalue   IN  VARCHAR2);

指定した名前と名前空間URIのDOMElementの属性値を設定します。

DBMS_XMLDOM.SETATTRIBUTE(
   elem       IN  DOMELEMENT,
   name       IN  VARCHAR2,
   newvalue   IN  VARCHAR2,
   ns         IN  VARCHAR2);

パラメータ

表206-119 SETATTRIBUTEプロシージャのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	属性名
`newvalue`	属性値
`ns`	ネームスペース

206.7.99 SETATTRIBUTENODEファンクション

このファンクションは、新規の属性ノードをDOMELEMENTに追加します。

参照:

構文

新規の属性ノードをDOMELEMENTに追加します。

DBMS_XMLDOM.SETATTRIBUTENODE(
   elem      IN  DOMELEMENT,
   newAttr   IN  DOMATTR)
 RETURN DOMATTR;

新規の属性ノードをDOMElementに追加し、名前空間を有効にします。

DBMS_XMLDOM.SETATTRIBUTENODE(
   elem      IN  DOMELEMENT,
   newAttr   IN  DOMATTR,
   ns        IN  VARCHAR2)
 RETURN DOMATTR;

パラメータ

表206-120 SETATTRIBUTENODEファンクションのパラメータ

パラメータ	説明
`elem`	`DOMELEMENT`
`newAttr`	新規の`DOMATTR`
`ns`	名前空間

206.7.100 SETCHARSETプロシージャ

このファンクションは、DOM文書の文字セットを設定します。

参照:

構文

DBMS_XMLDOM.SETCHARSET(
   doc      IN    DOMDocument,
   charset  IN    VARCHAR2);

パラメータ

表206-121 SETCHARSETプロシージャのパラメータ

パラメータ	説明
doc	`DOM`文書
charset	文字セット

使用上のノート

その時点で明示的に指定されていない場合、これはWRITETOFILEプロシージャに使用します。

206.7.101 SETDATAプロシージャ

このオーバーロードされたプロシージャは、文字データまたはDOMPROCESSINGINSTRUCTIONコンテンツ・データを設定します。特定の機能は、構文宣言に記載してあります。

構文

インタフェースを実装するノードの文字データを設定します(関連項目: 「DOMCharacterDataサブプログラム」)。

DBMS_XMLDOM.SETDATA(
   cd       IN     DOMCHARACTERDATA,
   data     IN     VARCHAR2);

DOMPROCESSINGINSTRUCTIONのコンテンツ・データを設定します(関連項目: 「DOMProcessingInstructionサブプログラム」)。

DBMS_XMLDOM.SETDATA(
   pi       IN     DOMPROCESSINGINSTRUCTION,
   data     IN     VARCHAR2);

パラメータ

表206-122 SETDATAプロシージャのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`data`	ノードに設定するデータ。
`pi`	`DOMPROCESSINGINSTRUCTION`
`data`	新規の処理命令のコンテンツ・データ。

206.7.102 SETDOCTYPEプロシージャ

DOM文書の場合、このプロシージャは、指定した名前、システム識別子、および公開識別子を持つ新しいDTDを作成して、DOM文書に設定します。

このDTDは、後でGETDOCTYPEファンクションを使用して取得できます。

構文

DBMS_XMLDOM.SETDOCTYPE(
  doc     IN   DOMDocument, 
  name    IN   VARCHAR2,
  sysid   IN   VARCHAR2, 
  pubid   IN   VARCHAR2);

パラメータ

表206-123 SETDOCTYPEプロシージャのパラメータ

パラメータ	説明
`doc`	DTDを設定するドキュメント。
`name`	doctypeの初期化で使用する名前。
`sysid`	doctypeの初期化で使用するシステム識別子。
`pubid`	doctypeの初期化で使用する公開識別子。

206.7.103 SETNAMEDITEMファンクション

このファンクションは、NodeName属性に基づいてノードを追加します。

指定した名前のノードがすでにマップ内に存在する場合は、そのノードは新規のノードで置き換えられます。このような置換が発生した場合は、既存のノードが戻り値となり、置換が発生しなかった場合は、NULLが戻されます。

ノードが格納される名前は、NodeName属性に基づいて決定されるため、特定タイプの複数のノード(特殊な文字列値を持つ複数のノード)は、名前が競合するために格納できません。このため、ノードに別名を付けることをお薦めします。

参照:

DOMNamedNodeMapサブプログラム

構文

NodeName属性に基づいて、ノードを追加します。

DBMS_XMLDOM.SETNAMEDITEM(
   nnm     IN     DOMNAMEDNODEMAP,
   arg     IN     DOMNODE)
 RETURN DOMNode;

NodeName属性と名前空間URIに基づいて、ノードを追加します。

DBMS_XMLDOM.SETNAMEDITEM(
   nnm     IN     DOMNAMEDNODEMAP,
   arg      IN    DOMNODE,
   ns      IN     VARCHAR2)
 RETURN DOMNode;

パラメータ

表206-124 SETNAMEDITEMファンクションのパラメータ

パラメータ	説明
`nnm`	`DOMNAMEDNODEMAP`
`arg`	`NodeName`属性に基づいて追加されるノード。
`ns`	ネームスペース

206.7.104 SETNODEVALUEプロシージャ

このプロシージャは、ノードのタイプに応じて、ノードの値を設定します。ノードの値をNULLに設定した場合は、この値を設定しても無効になります。

参照:

構文

DBMS_XMLDOM.SETNODEVALUE(
   n         IN     DOMNODE,
   nodeValue IN     VARCHAR2);

パラメータ

表206-125 SETNODEVALUEプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNode`
`nodeValue`	ノードに設定する値。

206.7.105 SETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャ

これらのサブプログラムの操作は、構文の項で説明されています。

参照:

構文

このファンクションは、コール元がノード値を書き込むことができるPL/SQL XMLBINARYOUTPUTSTREAMのインスタンスを戻します。ノードのデータ・タイプは、RAWまたはBLOBである必要があり、それ以外の場合は、例外が発生します。

DBMS_XMLDOM.SETNODEVALUEASBINARYSTREAM (
   n      IN     DOMNODE)
 RETURN SYS.UTL_BINARYOUTPUTSTREAM;

このプロシージャを使用して、アプリケーションは、XDBがノードに移入するデータを読み込むsys.utl_BinaryInputStreamの実装を渡します。ノードのデータ・タイプは、RAWまたはBLOBである必要があり、それ以外の場合は、例外が発生します。

DBMS_XMLDOM.SETNODEVALUEASBINARYSTREAM (
   n        in   DOMNODE, 
   value    in   SYS.UTL_BINARYINPUTSTREAM);

パラメータ

表206-126 SETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNODE`
value	`BINARYINPUTSTREAM`

206.7.106 SETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャ

これらのサブプログラムの操作は、構文の項で説明されています。

参照:

構文

このファンクションは、コール元がノード値を書き込むことができるPL/SQL XMLCHARACTEROUTPUTSTREAMタイプのインスタンスを戻します。ノードのデータ・タイプは、任意の有効なXDBデータ・タイプを使用できます。タイプが文字またはCLOBでない場合、ストリームに書き込まれる文字データは、ノードのデータ・タイプに変換されます。ノードのデータ・タイプが文字またはCLOBの場合、ストリームに書き込まれる文字データは、PL/SQLセッションの文字セットからノードの文字セットに変換されます。

DBMS_XMLDOM.SETNODEVALUEASCHARACTERSTREAM  (
   n        IN     DOMNODE)
 RETURN SYS.UTL_CHARACTEROUTPUTSTREAM;

このプロシージャを使用して、アプリケーションは、XDBがノードに移入するデータを読み込むSYS.UTL_CHARACTERINPUTSTREAMの実装を渡します。ノードのデータ・タイプは、XDBでサポートされている任意の有効なタイプを使用できます。文字以外のデータ・タイプの場合、ストリームから読み取られた文字データは、ノードのデータ・タイプに変換されます。ノードのデータ・タイプが文字またはCLOBの場合、変換は行われず、ノードの文字セットがPL/SQLセッションの文字セットとなります。

DBMS_XMLDOM.SETNODEVALUEASCHARACTERSTREAM  (
   n        IN   DOMNODE,
   value    IN   SYS.UTL_CHARACTERINPUTSTREAM);

パラメータ

表206-127 SETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNODE`
value	`CHARACTERINPUTSTREAM`

206.7.107 SETPREFIXプロシージャ

このプロシージャは、ノードの名前空間の接頭辞を指定の値に設定します。

参照:

構文

DBMS_XMLDOM.SETPREFIX(
   n       IN     DOMNODE,
   prefix  IN     VARCHAR2);

パラメータ

表206-128 SETPREFIXプロシージャのパラメータ

パラメータ	説明
`n`	`DOMNODE`
`prefix`	ノードに設定する名前空間の接頭辞の値。

206.7.108 SETSTANDALONEプロシージャ

このプロシージャは、DOMDOCUMENTのスタンドアロン・プロパティを設定します。

参照:

構文

DBMS_XMLDOM.SETSTANDALONE(
   doc         IN     DOMDOCUMENT,
   newvalue    IN     VARCHAR2);

パラメータ

表206-129 SETSTANDALONEプロシージャのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`newvalue`	ドキュメントのスタンドアロン・プロパティの値。

206.7.109 SETVALUEプロシージャ

このプロシージャは、属性の値を設定します。

参照:

構文

DBMS_XMLDOM.SETVALUE(
   a       IN     DOMATTR,
   value   IN     VARCHAR2);

パラメータ

表206-130 SETVALUEプロシージャのパラメータ

パラメータ	説明
`a`	`DOMATTR`
`value`	属性に設定する値。

206.7.110 SETVERSIONプロシージャ

このプロシージャは、DOMDOCUMENTのバージョンを設定します。

参照:

DBMS_XMLDOM DOMTextサブプログラム

構文

DBMS_XMLDOM.SETVERSION(
   doc        IN     DOMDOCUMENT,
   version    IN     VARCHAR2);

パラメータ

表206-131 SETVERSIONプロシージャのパラメータ

パラメータ	説明
`doc`	`DOMDOCUMENT`
`version`	ドキュメントのバージョン。

206.7.111 SPLITTEXTファンクション

このファンクションは、指定したオフセット位置で、1つのDOMTEXTノードを2つのDOMTEXTノードに分割します。

参照:

構文

DBMS_XMLDOM.SPLITTEXT(
   t        IN     DOMTEXT,
   offset   IN     NUMBER)
 RETURN DOMText;

パラメータ

表206-132 SPLITTEXTファンクションのパラメータ

パラメータ	説明
`t`	`DOMTEXT`
`offset`	分割を行うオフセット。

206.7.112 SUBSTRINGDATAファンクション

このファンクションは、指定された範囲のデータ(サブストリング)をノードから抽出します。

参照:

構文

DBMS_XMLDOM.SUBSTRINGDATA(
   cd        IN     DOMCHARACTERDATA,
   offset    IN     NUMBER,
   cnt       IN     NUMBER)
 RETURN VARCHAR2;

パラメータ

表206-133 SUBSTRINGDATAファンクションのパラメータ

パラメータ	説明
`cd`	`DOMCHARACTERDATA`
`offset`	取得するデータの開始オフセット。
`cnt`	取得するデータの(オフセットからの)文字数。

206.7.113 USEBINARYSTREAMファンクション

このファンクションは、ノードのデータ・タイプがRAWまたはBLOB,の場合、UTL_BINARYINPUTSTREAMまたはUTL_BINARYOUTPUTSTREAMを使用してノード値を読取りまたは書込みできるように、TRUEを戻します。

FALSEの値が返された場合、ノード値はUTL_CHARACTERINPUTSTREAMまたはUTL_CHARACTEROUTPUTSTREAMでのみアクセスできます。

参照: