191 DBMS_XMLDOM

構文

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

パラメータ

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

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

APPENDDATAプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

CLONENODEファンクション

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

関連項目:

構文

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

パラメータ

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

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

使用上の注意

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

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;

パラメータ

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

パラメータ	説明
`doc`	`DOMDOCUMENT`
`qname`	新規の属性修飾名。
`ns`	名前空間。

CREATECDATASECTIONファンクション

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

関連項目:

構文

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

パラメータ

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

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

CREATECOMMENTファンクション

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

関連項目:

構文

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

パラメータ

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

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

CREATEDOCUMENTファンクション

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

関連項目:

構文

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

パラメータ

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

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

CREATEDOCUMENTFRAGMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.CREATEDOCUMENTFRAGMENT(
   doc      IN     DOMDOCUMENT)
 RETURN DOMDOCUMENTFRAGMENT;

パラメータ

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

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

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;

パラメータ

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

パラメータ	説明
`doc`	`DOMDOCUMENT`
`tagName`	新しい`DOMELEMENT`のタグ名。
`ns`	名前空間。

CREATEENTITYREFERENCEファンクション

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

関連項目:

構文

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

パラメータ

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

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

CREATEPROCESSINGINSTRUCTIONファンクション

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

関連項目:

構文

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

パラメータ

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

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

CREATETEXTNODEファンクション

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

関連項目:

構文

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

パラメータ

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

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

DELETEDATAプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

FINDENTITYファンクション

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

関連項目:

構文

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

パラメータ

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

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

FINDNOTATIONファンクション

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

関連項目:

構文

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

パラメータ

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

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

FREEDOCFRAGプロシージャ

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

構文

DBMS_XMLDOM.FREEDOCFRAG(
   df    IN    DOMDOCUMENTFRAGMENT);

パラメータ

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

パラメータ	説明
`df`	DOMDocumentFragment。

FREEDOCUMENTプロシージャ

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

関連項目:

構文

DBMS_XMLDOM.FREEDOCUMENT(
   doc     IN     DOMDOCUMENT);

パラメータ

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

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

FREEELEMENTプロシージャ

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

関連項目:

構文

DBMS_XMLDOM.FREENODE(
   elem      IN     DOMELEMENT);

パラメータ

表191-40 FREENODEプロシージャのパラメータ

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

FREENODEプロシージャ

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

関連項目:

構文

DBMS_XMLDOM.FREENODE(
   n      IN     DOMNODE);

パラメータ

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

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

FREENODELISTプロシージャ

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

関連項目:

DOMNodeListサブプログラム

構文

DBMS_XMLDOM.FREENODE(
   nl    IN    DOMNodeList);

パラメータ

表191-42 FREENODEプロシージャのパラメータ

パラメータ	説明
`n`l	`DOMNODELIST`タイプ

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;

パラメータ

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

パラメータ	説明
`elem`	`DOMELEMENT`。
`name`	属性名。
`ns`	名前空間。

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;

パラメータ

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

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

GETATTRIBUTESファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETATTRIBUTES(
   n      IN      DOMNode)
 RETURN DOMNAMEDNODEMAP;

パラメータ

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

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

GETCHARSETファンクション

このファンクションは、DOM文書のキャラクタ・セットを取得します。

関連項目:

構文

DBMS_XMLDOM.GETCHARSET(
   doc IN    DOMDocument)
 RETURN VARCHAR2;

パラメータ

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

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

使用上の注意

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

GETCHILDNODESファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETCHILDNODES(
   n      IN    DOMNode)
 RETURN DOMNodeList;

パラメータ

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

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

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;

パラメータ

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

パラメータ	説明
`elem`	`DOMELEMENT`
`name`	タグ名。
`ns`	名前空間。

GETDATAファンクション

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

構文

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

DBMS_XMLDOM.GETDATA(
   cd      IN    DOMCHARACTERDATA)
 RETURN VARCHAR2;

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

DBMS_XMLDOM.GETDATA(
   pi      IN    DOMPROCESSINGINSTRUCTION)
 RETURN VARCHAR2;

パラメータ

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

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

GETDOCTYPEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETDOCTYPE(
   doc      IN     DOMDOCUMENT)
RETURN DOMDOCUMENTTYPE;

パラメータ

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

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

GETDOCUMENTELEMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETDOCUMENTELEMENT(
   doc      IN      DOMDOCUMENT)
 RETURN DOMELEMENT;

パラメータ

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

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

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;

パラメータ

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

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

GETENTITIESファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETENTITIES(
   dt      IN     DOMDocumentType)
 RETURN DOMNAMEDNODEMAP;

パラメータ

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

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

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;

パラメータ

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

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

GETFIRSTCHILDファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETFIRSTCHILD(
   n      IN      DOMNODE)
 RETURN DOMNODE;

パラメータ

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

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

GETIMPLEMENTATIONファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETIMPLEMENTATION(
   doc      IN     DOMDOCUMENT)
 RETURN DOMIMPLEMENTATION;

パラメータ

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

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

GETLASTCHILDファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETLASTCHILD(
   n     IN   DOMNODE)
 RETURN DOMNODE;

パラメータ

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

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

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;

パラメータ

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

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

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;

パラメータ

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

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

GETNAMEファンクション

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

構文

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

DBMS_XMLDOM.GETNAME(
   a       IN     DOMATTR)
 RETURN VARCHAR2;

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

DBMS_XMLDOM.GETNAME(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN VARCHAR2;

パラメータ

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

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

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;

パラメータ

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

パラメータ	説明
`nnm`	`DOMNAMEDNODEMAP`
`name`	取得する項目の名前。
`ns`	名前空間。

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;

パラメータ

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

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

GETNEXTSIBLINGファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETNEXTSIBLING(
   n       IN     DOMNODE)
 RETURN DOMNode;

パラメータ

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

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

GETNODETYPEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETNODETYPE(
   n       IN     DOMNODE)
 RETURN NUMBER;

パラメータ

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

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

GETNODENAMEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETNODENAME(
   n       IN     DOMNODE)
 RETURN VARCHAR2;

パラメータ

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

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

GETNODEVALUEファンクション

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

関連項目:

構文

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

パラメータ

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

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

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);

パラメータ

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

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

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);

パラメータ

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

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

GETNOTATIONNAMEファンクション

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

関連項目:

DOMEntityサブプログラム

構文

DBMS_XMLDOM.GETNOTATIONNAME(
   ent       IN     DOMENTITY)
 RETURN VARCHAR2;

パラメータ

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

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

GETNOTATIONSファンクション

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

関連項目:

DOMProcessingInstructionサブプログラム

構文

DBMS_XMLDOM.GETNOTATIONS(
   dt       IN     DOMDOCUMENTTYPE)
 RETURN DOMNAMEDNODEMAP;

パラメータ

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

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

GETTARGETファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETTARGET(
   pi       IN     DOMPROCESSINGINSTRUCTION)
 RETURN VARCHAR2;

パラメータ

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

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

GETOWNERDOCUMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETOWNERDOCUMENT(
   n       IN     DOMNODE)
 RETURN DOMDOCUMENT;

パラメータ

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

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

GETOWNERELEMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETOWNERELEMENT(
   a       IN     DOMATTR)
 RETURN DOMElement;

パラメータ

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

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

GETPARENTNODEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETPARENTNODE(
   n       IN     DOMNODE)
 RETURN DOMNODE;

パラメータ

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

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

GETPREFIXファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETPREFIX(
   n       IN     DOMNODE)
 RETURN VARCHAR2;

パラメータ

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

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

GETPREVIOUSSIBLINGファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETPREVIOUSSIBLING(
   n       IN     DOMNODE)
 RETURN DOMNODE;

パラメータ

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

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

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;

パラメータ

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

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

GETQUALIFIEDNAMEファンクション

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

構文

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

DBMS_XMLDOM.GETQUALIFIEDNAME(
   a        IN     DOMATTR)
 RETURN VARCHAR2;

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

DBMS_XMLDOM.GETQUALIFIEDNAME(
   elem     IN     DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

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

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

GETSCHEMANODEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETSCHEMANODE(
   n       IN     DOMNODE)
 RETURN DOMNODE;

パラメータ

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

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

GETSPECIFIEDファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETSPECIFIED(
   a       IN     DOMATTR)
 RETURN BOOLEAN;

パラメータ

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

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

GETSTANDALONEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETSTANDALONE(
   doc       IN     DOMDOCUMENT)
 RETURN VARCHAR2;

パラメータ

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

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

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;

パラメータ

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

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

GETTAGNAMEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETTAGNAME(
   elem       IN     DOMELEMENT)
 RETURN VARCHAR2;

パラメータ

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

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

GETVALUEファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETVALUE(
   a       IN     DOMATTR)
 RETURN VARCHAR2;

パラメータ

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

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

GETVERSIONファンクション

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

関連項目:

構文

DBMS_XMLDOM.GETVERSION(
   doc       IN     DOMDOCUMENT)
 RETURN VARCHAR2;

パラメータ

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

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

GETXMLTYPEファンクション

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

関連項目:

構文

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

パラメータ

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

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

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;

パラメータ

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

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

HASATTRIBUTESファンクション

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

関連項目:

構文

DBMS_XMLDOM.HASATTRIBUTES(
   n       IN     DOMNODE)
 RETURN BOOLEAN;

パラメータ

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

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

HASCHILDNODESファンクション

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

関連項目:

構文

DBMS_XMLDOM.HASCHILDNODES(
   n       IN     DOMNODE)
 RETURN BOOLEAN;

パラメータ

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

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

HASFEATUREファンクション

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

関連項目:

DOMImplementationサブプログラム

構文

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

パラメータ

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

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

IMPORTNODEファンクション

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

関連項目:

構文

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

パラメータ

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

パラメータ説明

doc

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

importedNode

インポートするノード。

deep

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

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

使用上の注意

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;

パラメータ

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

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

INSERTDATAプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

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;

パラメータ

表191-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`。

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;

パラメータ

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

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

MAKEATTRファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEATTR(
   n       IN     DOMNODE)
 RETURN DOMATTR;

パラメータ

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

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

MAKECDATASECTIONファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKECDATASECTION(
   n       IN     DOMNODE)
 RETURN DOMCDATASECTION;

パラメータ

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

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

MAKECHARACTERDATAファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKECHARACTERDATA(
   n       IN     DOMNode)
 RETURN DOMCharacterData;

パラメータ

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

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

MAKECOMMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKECOMMENT(
   n       IN     DOMNODE)
 RETURN DOMCOMMENT;

パラメータ

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

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

MAKEDOCUMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEDOCUMENT(
   n       IN     DOMNODE)
 RETURN DOMDocument;

パラメータ

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

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

MAKEDOCUMENTFRAGMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEDOCUMENTFRAGMENT(
   n       IN     DOMNODE)
 RETURN DOMDOCUMENTFRAGMENT;

パラメータ

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

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

MAKEDOCUMENTTYPEファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEDOCUMENTTYPE(
   n       IN     DOMNODE)
 RETURN DOMDOCUMENTTYPE;

パラメータ

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

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

MAKEELEMENTファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEELEMENT(
   n       IN     DOMNODE)
 RETURN DOMELEMENT;

パラメータ

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

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

MAKEENTITYファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEENTITY(
   n       IN     DOMNODE)
 RETURN DOMENTITY;

パラメータ

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

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

MAKEENTITYREFERENCEファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEENTITYREFERENCE(
   n       IN     DOMNODE)
 RETURN DOMENTITYREFERENCE;

パラメータ

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

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

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;

パラメータ

表191-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`。

MAKENOTATIONファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKENOTATION(
   n       IN     DOMNODE)
 RETURN DOMNOTATION;

パラメータ

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

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

MAKEPROCESSINGINSTRUCTIONファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKEPROCESSINGINSTRUCTION(
   n       IN     DOMNODE)
 RETURN DOMPROCESSINGINSTRUCTION;

パラメータ

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

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

MAKETEXTファンクション

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

関連項目:

構文

DBMS_XMLDOM.MAKETEXT(
   n       IN     DOMNODE)
 RETURN DOMTEXT;

パラメータ

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

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

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;

パラメータ

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

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

NORMALIZEプロシージャ

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

関連項目:

構文

DBMS_XMLDOM.NORMALIZE(
   elem       IN     DOMELEMENT);

パラメータ

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

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

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);

パラメータ

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

パラメータ	説明
`elem`	`DOMELEMENT`。
`name`	属性名。
`ns`	名前空間。

REMOVEATTRIBUTENODEファンクション

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

関連項目:

構文

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

パラメータ

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

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

REMOVECHILDファンクション

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

関連項目:

構文

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

パラメータ

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

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

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;

パラメータ

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

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

REPLACECHILDファンクション

このファンクションは、子ノード・リスト内において、既存の子ノードoldchildを新しい子ノードnewchildで置き換え、そのoldchildノードを戻します。newchildがDocumentFragmentオブジェクトの場合、oldchildは、DocumentFragmentのすべての子ノードで置き換えられます(これらの子ノードは、DocumentFragment内と同じ順序で挿入されます)。newchildがすでにツリーに追加されている場合は、そのノードが最初に削除されます。

関連項目:

構文

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

パラメータ

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

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

REPLACEDATAプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

RESOLVENAMESPACEPREFIXファンクション

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

関連項目:

構文

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

パラメータ

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

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

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);

パラメータ

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

パラメータ	説明
`elem`	`DOMELEMENT`。
`name`	属性名。
`newvalue`	属性値。
`ns`	名前空間。

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;

パラメータ

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

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

SETCHARSETプロシージャ

このファンクションは、DOM文書のキャラクタ・セットを設定します。

関連項目:

構文

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

パラメータ

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

パラメータ	説明
doc	`DOM`文書
charset	キャラクタ・セット

使用上の注意

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

SETDATAプロシージャ

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

構文

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

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

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

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

パラメータ

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

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

SETDOCTYPEプロシージャ

DOM文書の場合、このプロシージャは、指定した名前、システム識別子、および公開識別子を持つ新しいDTDを作成して、DOM文書に設定します。このDTDは、後でGETDOCTYPEファンクションを使用して取得できます。

構文

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

パラメータ

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

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

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;

パラメータ

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

パラメータ	説明
`nnm`	`DOMNAMEDNODEMAP`
`arg`	`NodeName`属性に基づいて追加されるノード。
`ns`	名前空間。

SETNODEVALUEプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

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);

パラメータ

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

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

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);

パラメータ

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

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

SETPREFIXプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

SETSTANDALONEプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

SETVALUEプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

SETVERSIONプロシージャ

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

関連項目:

構文

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

パラメータ

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

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

SPLITTEXTファンクション

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

関連項目:

DOMTextサブプログラム

構文

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

パラメータ

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

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

SUBSTRINGDATAファンクション

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

関連項目:

構文

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

パラメータ

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

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

USEBINARYSTREAMファンクション

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

関連項目: