DBMS_XMLDOM
パッケージは、XMLType
オブジェクトへのアクセスに使用されます。また、このパッケージによって、HTMLドキュメントとXML文書用のApplication Program Interface(API)であるDocument Object Model(DOM)が実装されます。
関連項目: 『Oracle XML Developer's Kitプログラマーズ・ガイド』 |
この章では、次の項目について説明します。
概要
セキュリティ・モデル
定数
タイプ
例外
DOMNodeサブプログラム
DOMAttrサブプログラム
DOMCDataSectionサブプログラム
DOMCharacterDataサブプログラム
DOMCommentサブプログラム
DOMDocumentサブプログラム
DOMDocumentFragmentサブプログラム
DOMDocumentTypeサブプログラム
DOMElementサブプログラム
DOMEntityサブプログラム
DOMEntityReferenceサブプログラム
DOMImplementationサブプログラム
DOMNamedNodeMapサブプログラム
DOMNodeListサブプログラム
DOMNotationサブプログラム
DOMProcessingInstructionサブプログラム
DOMTextサブプログラム
Document Object Model (DOM)は、HTMLドキュメントとXML文書用のApplication Program Interface (API)です。DOMは、ドキュメントの論理構造、およびドキュメントへのアクセスと操作の方法を定義します。DOM仕様では、「ドキュメント」という用語が広い意味で使用されます。XMLは、様々なシステムに保存される数多くの種類の情報を表す言語として、急速に普及してきました。これらの情報は従来「データ」と呼ばれていますが、XMLではこのデータをドキュメント(文書)として表現し、DBMS_XMLDOM
パッケージでは、スキーマ・ベースのドキュメントと、非スキーマ・ベースのドキュメントの両方を操作できます。
注意:
|
DOMを使用すると、HTMLまたはXML文書の内容へのアクセス、変更、削除または追加を行うことができますが、いくつかの例外があります。特に、XMLの内部および外部のサブセットに対するDOMインタフェースは、まだ仕様化されていません。
DOMのW3C仕様の重要な目的の1つは、広範な環境、プログラミング言語、アプリケーションで使用できる標準的なプログラミング・インタフェースを提供することです。DOM標準はオブジェクト指向ですが、PL/SQLは本質的に手続き型言語であるため、次の変更が必要でした。
各種のDOMインタフェース(Node
、Element
など)には、同等のPL/SQLタイプ(それぞれ、DOMNode
、DOMElement
など)があります。
各種のDOMException
コード(WRONG_DOCUMENT_ERR
、HIERARCHY_REQUEST_ERR
など)には、同じ名前のPL/SQL例外があります。
各種のDOMノード・タイプ・コード(ELEMENT_NODE
、ATTRIBUTE_NODE
など)には、同じ名前のPL/SQL定数があります。
DOMタイプに対して定義されたサブプログラムは、そのDOMタイプをパラメータとして受け取るファンクションまたはプロシージャになります。たとえば、DOMNode
n
に対してAPPENDCHILDファンクションを実行するために、PL/SQLファンクション(APPENDCHILDファンクション)が用意されています。
DOMElement elem
に対してsetAttribute
を実行するには、PL/SQLプロシージャ(SETATTRIBUTEプロシージャ)を使用します。
DOMでは、継承の階層が定義されています。たとえば、Document
、Element
およびAttr
は、Node
のサブタイプとして定義されています(図171-1を参照)。したがって、Node
インタフェースで定義されているメソッドは、これらのサブタイプでも使用できます。PL/SQLではこのような継承がサポートされないため、MAKENODE
ファンクションを直接コールすることによって継承が実現されています。様々なDOMタイプに対してMAKENODE
をコールすると、それらのDOMタイプがDOMNode
に変換されます。次に、DOMNode
を受け取る適切なファンクションまたはプロシージャをコールすれば、これらのDOMNodeを操作できます。その後、各DOMタイプに固有の機能が必要な場合は、make
XXX
ファンクション(DOM
XXX
は目的のDOMタイプ)をコールすれば、DOMNode
を元のDOMタイプに再変換できます。
このインタフェースは、REC-DOM-Level-1-19981001に基づいて実装されています。
DBMS_XMLDOM
パッケージは、XDB
が所有しているため、SYS
またはXDB
によって作成される必要があります。EXECUTE
権限は、PUBLIC
に付与されます。このパッケージ内のサブプログラムは、現行のユーザーの権限を使用して実行されます。
表171-1に、DBMS_XMLDOM
で定義されている定数を示します。
表171-1 DBMS_XMLDOMの事前定義定数
定数 | タイプ | 値 | 説明 |
---|---|---|---|
|
|
1 |
ノードは要素です。 |
|
|
2 |
ノードは属性です。 |
|
|
3 |
ノードはテキスト・ノードです。 |
|
|
4 |
ノードはCDataSectionです。 |
|
|
5 |
ノードは実体参照です。 |
|
|
6 |
ノードはエンティティです。 |
|
|
7 |
ノードは処理命令です。 |
|
|
8 |
ノードはコメントです。 |
|
|
9 |
ノードはドキュメントです。 |
|
|
10 |
ノードはDocument Type Definition(DTD)です。 |
|
|
11 |
ノードはドキュメント・フラグメントです。 |
|
|
12 |
ノードは表記法です。 |
表171-2に、DBMS_XMLDOM.DOMTYPE
で定義されているタイプを示します。
表171-2 XDB_XMLDOMタイプ
タイプ | 説明 |
---|---|
|
DOMのAttrインタフェースを実装します。 |
|
DOMのCDataSectionインタフェースを実装します。 |
|
DOMのCharacterDataインタフェースを実装します。 |
|
DOMのCommentインタフェースを実装します。 |
|
DOMのDocumentインタフェースを実装します。 |
|
DOMのDocumentFragmentインタフェースを実装します。 |
|
DOMのDocumentTypeインタフェースを実装します。 |
|
DOMのElementインタフェースを実装します。 |
|
DOMのEntityインタフェースを実装します。 |
|
DOMのEntityReferenceインタフェースを実装します。 |
|
DOMのImplementationインタフェースを実装します。 |
|
DOMのNamedNodeMapインタフェースを実装します。 |
|
DOMのNodeインタフェースを実装します。 |
|
DOMのNodeListインタフェースを実装します。 |
|
DOMのNotationインタフェースを実装します。 |
|
DOMのProcessingInstructionインタフェースを実装します。 |
|
DOMのTextインタフェースを実装します。 |
表171-3に、DBMS_XMLDOM
で定義されている例外を示します。
表171-3 DBMS_XMLDOMの例外
例外 | 説明 |
---|---|
|
指定したテキスト範囲が |
|
ノードが属していない場所にノードが挿入された場合。 |
|
索引またはサイズが負数か、許容値を超えている場合。 |
|
すでに他で使用中の属性を追加しようとした場合。 |
|
名前などに指定した文字が無効な場合。有効な文字の定義についてはXML Specificationのproduction 2を、有効な名前文字の定義についてはproduction 5を参照してください。 |
|
データをサポートしないノードにデータが指定された場合。 |
|
ノードが存在しないコンテキストでノードを参照しようとした場合。 |
|
変更不可のオブジェクトを変更しようとした場合。 |
|
要求されたタイプのオブジェクトまたは操作が実装でサポートされていない場合。 |
|
ノードを作成したドキュメント以外のドキュメント(そのノードをサポートしていない)でそのノードが使用された場合。 |
DBMS_XMLDOM
サブプログラムは、W3Cインタフェースに従って複数のグループに分割されます。
表171-4 DBMS_XMLDOM - DOMNodeサブプログラムの要約
サブプログラム | 説明 |
---|---|
|
別のドキュメントからノードを採用します。 |
|
新規の子をノードに追加します。 |
|
ノードをクローニングします。 |
|
ノードに関連付けられたすべてのリソースを解放します。 |
|
ノードの属性を取得します。 |
|
ノードの子を取得します。 |
|
ノードの拡張名を取得します。 |
|
ノードの最初の子を取得します。 |
|
ノードの最後の子を取得します。 |
|
修飾名のローカル部分を取得します。 |
|
ノードの名前空間URIを取得します。 |
|
ノードの次の兄弟関係を取得します。 |
|
ノードの名前を取得します。 |
|
ノードのタイプを取得します。 |
|
ノードの値を取得します。 |
GETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャ |
ノード値をバイナリ・ストリームとして取得します。 |
GETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャ |
ノード値を文字ストリームとして取得します。 |
|
ノードの所有者ドキュメントを取得します。 |
ノードの親を取得します。 |
|
|
名前空間の接頭辞を取得します。 |
|
ノードの直前の兄弟関係を取得します。 |
|
関連付けられたスキーマURIを取得します。 |
|
ノードに属性が存在するかどうかをテストします。 |
|
ノードに子ノードが存在するかどうかをテストします。 |
|
別のドキュメントからノードをインポートします。 |
|
参照先の子の前に子を挿入します。 |
|
ノードが |
|
ノードをAttrに変換します。 |
|
ノードをCDataSectionに変換します。 |
|
ノードをCharacterDataに変換します。 |
|
ノードをCommentに変換します。 |
|
ノードをDOMDocumentに変換します。 |
|
ノードをDOMDocumentFragmentに変換します。 |
|
ノードをDOMDcumentTypeに変換します。 |
|
ノードをDOMElementに変換します。 |
|
ノードをDOMEntityに変換します。 |
|
ノードをDOMEntityReferenceに変換します。 |
|
ノードをDOMNotationに変換します。 |
MAKEPROCESSINGINSTRUCTIONファンクション |
ノードをDOMProcessingInstructionに変換します。 |
|
ノードをDOMTextに変換します。 |
|
指定した子をノードから削除します。 |
|
既存の子ノードを新規の子ノードで置き換えます。 |
|
ノードの値を設定します。 |
SETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャ |
ノード値をバイナリ・ストリームとして設定します。 |
SETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャ |
ノード値を文字ストリームとして設定します。 |
|
名前空間の接頭辞を設定します。 |
|
ストリームが有効であることを確認します。 |
|
ノードの内容をバッファに書き込みます。 |
|
ノードの内容を |
|
ノードの内容をファイルに書き込みます。 |
表171-9 DBMS_XMLDOM - DOMDocumentサブプログラムの要約
メソッド | 説明 |
---|---|
|
属性を作成します。 |
|
|
|
コメント・ノードを作成します。 |
|
新規ドキュメントを作成します。 |
|
新規のドキュメント・フラグメントを作成します。 |
|
新規の要素を作成します。 |
|
実体参照を作成します。 |
CREATEPROCESSINGINSTRUCTIONファンクション |
処理命令を作成します。 |
|
テキスト・ノードを作成します。 |
|
ドキュメント・フラグメントを解放します。 |
|
ドキュメントを解放します。 |
|
|
|
ドキュメントのDTDを取得します。 |
|
ドキュメントのルート要素を取得します。 |
|
次のものを取得します。
|
|
DOMの実装を取得します。 |
|
ドキュメントのスタンドアロン・プロパティを取得します。 |
|
ドキュメントのバージョンを取得します。 |
|
DOMDocumentに関連付けられた |
|
ドキュメントが |
|
ドキュメントをノードに変換します。 |
|
新規ドキュメントを作成します。 |
|
|
|
ドキュメントのDTDを設定します。 |
|
ドキュメントのスタンドアロン・プロパティを設定します。 |
|
ドキュメントのバージョンを設定します。 |
|
ドキュメントをバッファに書き込みます。 |
|
ドキュメントを |
|
ドキュメントをファイルに書き込みます。 |
表171-12 DBMS_XMLDOM - DOMElementサブプログラムの要約
メソッド | 説明 |
---|---|
|
DOMElementハンドルに割り当てられているメモリーを解放します。 |
|
指定した名前の属性ノードを取得します。 |
|
指定した名前の属性ノードを取得します。 |
|
タグ名を指定して要素の子を取得します。 |
|
次のものを取得します。
|
|
要素の拡張名を取得します。 |
|
要素のローカル名を取得します。 |
|
要素の名前空間URIを取得します。 |
|
要素の修飾名を取得します。 |
|
要素のタグ名を取得します。 |
|
指定した属性が定義されているかどうかをテストします。 |
|
要素が |
|
要素をノードに変換します。 |
|
要素のテキストの子を正規化します。 |
|
指定した名前の属性を削除します。 |
|
要素内の属性ノードを削除します。 |
|
指定した名前空間URIの接頭辞を解決します。 |
|
指定した名前の属性を設定します。 |
|
属性ノードを要素に追加します。 |
表171-21 DBMS_XMLDOMパッケージのサブプログラムの要約
サブプログラム | 説明 | グループ |
---|---|---|
|
別のドキュメントからノードを採用します。 |
|
|
新規の子をノードに追加します。 |
|
|
指定したデータをノード・データに追加します。 |
|
|
ノードをクローニングします。 |
|
|
属性を作成します。 |
|
|
|
|
|
コメント・ノードを作成します。 |
|
|
新規ドキュメントを作成します。 |
|
|
新規のドキュメント・フラグメントを作成します。 |
|
|
新規の要素を作成します。 |
|
|
実体参照を作成します。 |
|
CREATEPROCESSINGINSTRUCTIONファンクション |
処理命令を作成します。 |
|
|
テキスト・ノードを作成します。 |
|
|
指定したオフセットからデータを削除します。 |
|
|
ドキュメント・タイプで指定のエンティティを検索します。 |
|
|
ドキュメント・タイプで指定の表記法を検索します。 |
|
|
ドキュメント・フラグメントを解放します。 |
|
|
ドキュメントを解放します。 |
|
|
DOMElementハンドルに割り当てられているメモリーを解放します。 |
|
|
ノードに関連付けられたすべてのリソースを解放します。 |
|
|
ノード・リストに関連付けられたすべてのリソースを解放します。 |
|
|
指定した名前の属性ノードを取得します。 |
|
|
指定した名前の属性ノードを取得します。 |
|
|
ノードの属性を取得します。 |
|
|
|
|
|
ノードの子を取得します。 |
|
|
タグ名を指定して要素の子を取得します。 |
|
|
次のものを取得します。
|
|
|
ドキュメントのDTDを取得します。 |
|
|
ドキュメントのルート要素を取得します。 |
|
|
次のものを取得します。
|
|
|
ドキュメント・タイプのエンティティのノードマップを取得します。 |
|
|
次のものを取得します。
|
|
|
ノードの最初の子を取得します。 |
|
|
DOMの実装を取得します。 |
|
|
ノードの最後の子を取得します。 |
|
|
次のものを取得します。
|
|
|
次のものを取得します。
|
|
|
次のものを取得します。
|
|
|
次のものを取得します。
|
|
|
次のものを取得します。
|
|
|
ノードの次の兄弟関係を取得します。 |
|
|
ノードの名前を取得します。 |
|
|
ノードのタイプを取得します。 |
|
|
ノードの値を取得します。 |
|
GETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャ |
ノード値をバイナリ・ストリームとして取得します。 |
|
GETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャ |
ノード値を文字ストリームとして取得します。 |
|
|
エンティティの表記法の名前を取得します。 |
|
|
ドキュメント・タイプの表記法のノードマップを取得します。 |
|
|
処理命令のターゲットを取得します。 |
DOMProcessingInstructionサブプログラム |
|
ノードの所有者ドキュメントを取得します。 |
|
|
属性の親である要素ノードを取得します。 |
|
ノードの親を取得します。 |
|
|
|
名前空間の接頭辞を取得します。 ) |
|
|
ノードの直前の兄弟関係を取得します。 |
|
|
次のものを取得します。
|
|
|
次のものを取得します。
|
|
|
関連付けられたスキーマURIを取得します。 |
|
|
要素に属性が指定されているかどうかをテストします。 |
|
|
ドキュメントのスタンドアロン・プロパティを取得します。 |
|
|
次のものを取得します。
|
|
|
要素のタグ名を取得します。 |
|
|
属性の値を取得します。 |
|
|
ドキュメントのバージョンを取得します。 |
|
|
DOMDocumentに関連付けられた |
|
|
ノードに属性が存在するかどうかをテストします。 |
|
|
指定した属性が定義されているかどうかをテストします。 |
|
|
ノードに子ノードが存在するかどうかをテストします。 |
|
|
|
|
|
別のドキュメントからノードをインポートします。 |
|
|
参照先の子の前に子を挿入します。 |
|
|
指定したオフセットでノード内にデータを挿入します。 |
|
|
次のテストを実行します。
|
|
|
次のものを取得します。
|
|
|
ノードをAttrに変換します。 |
|
|
ノードをCDataSectionに変換します。 |
|
|
ノードをCharacterDataに変換します。 |
|
|
ノードをCommentに変換します。 |
|
|
ノードをDOMDocumentに変換します。 |
|
|
ノードをDOMDocumentFragmentに変換します。 |
|
|
ノードをDOMDcumentTypeに変換します。 |
|
|
ノードをDOMElementに変換します。 |
|
|
ノードをDOMEntityに変換します。 |
|
|
ノードをDOMEntityReferenceに変換します。 |
|
|
次の変換を実行します。
|
|
|
ノードをDOMNotationに変換します。 |
|
MAKEPROCESSINGINSTRUCTIONファンクション |
ノードをDOMProcessingInstructionに変換します。 |
|
|
ノードをDOMTextに変換します。 |
|
|
新規ドキュメントを作成します。 |
|
|
要素のテキストの子を正規化します。 |
|
|
指定した名前の属性を削除します。 |
|
|
要素内の属性ノードを削除します。 |
|
|
指定した子をノードから削除します。 |
|
|
指定した名前の項目を削除します。 |
|
|
既存の子ノードを新規の子ノードで置き換えます。 |
|
|
ノード内の特定範囲の文字列を新しい文字列で置き換えます。 |
|
|
指定した名前空間URIの接頭辞を解決します。 |
|
|
指定した名前の属性を設定します。 |
|
|
属性ノードを要素に追加します。 |
|
|
|
|
|
次のデータを設定します。
|
|
|
ドキュメントのDTDを設定します。 |
|
|
指定した名前の項目をマップに追加します。 |
|
|
ノードの値を設定します。 |
|
SETNODEVALUEASBINARYSTREAMファンクションおよびプロシージャ |
ノード値をバイナリ・ストリームとして設定します。 |
|
SETNODEVALUEASCHARACTERSTREAMファンクションおよびプロシージャ |
ノード値を文字ストリームとして設定します。 |
|
|
名前空間の接頭辞を設定します。 |
|
|
ドキュメントのスタンドアロン・プロパティを設定します。 |
|
|
属性の値を設定します。 |
|
|
ドキュメントのバージョンを設定します。 |
|
|
テキスト・ノードの内容を2つのテキスト・ノードに分割します。 |
|
|
データのサブストリングを取得します。 |
|
|
ストリームが使用に有効であることを確認します。 |
|
|
次の書込み処理を実行します。
|
|
|
次の書込み処理を実行します。
|
|
|
次の書込み処理を実行します。
|
|
このファンクションは、ノードnewchild
を、指定したノードの子ノード・リストの最後に追加し、新しく追加したノードを戻します。newchild
がすでにツリーに追加されている場合は、そのノードが最初に削除されます。
このファンクションは、指定したノードの複製を戻し、ノードの汎用コピー・コンストラクタとして機能します。複製ノードに親はないため、複製ノードの親ノードはNULL
になります。
このファンクションは、DOMATTR
ノードを作成します。
このファンクションは、指定した名前空間URI、ルート要素名、DTDを持つDOMDOCUMENT
ノードを作成します。
このファンクションは、DOMELEMENT
を作成します。
このファンクションは、DOMENTITYREFERENCE
ノードを作成します。
このファンクションは、DOMPROCESSINGINSTRUCTION
ノードを作成します。
このファンクションは、指定のDTDでエンティティを検索し、見つかった場合はそのエンティティを戻します。
このファンクションは、指定した名前のDOMELEMENT
の属性値を戻します。
このファンクションは、指定した名前のDOMELEMENT
の属性ノードを戻します。このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
このファンクションは、指定したノードのすべての子ノードを含むDOMNODELIST
を取得します。子ノードが存在しない場合は、ノードを含まないDOMNODELIST
になります。
このファンクションは、DOMELEMENT
の子を戻します。
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
インタフェースを実装するノードの文字データを取得します(関連項目: 「DOMCharacterDataサブプログラム」)。
DBMS_XMLDOM.GETDATA( cd IN DOMCHARACTERDATA) RETURN VARCHAR2;
DOMProcessingInstruction
のコンテンツ・データを戻します(関連項目: 「DOMProcessingInstructionサブプログラム」)。
DBMS_XMLDOM.GETDATA( pi IN DOMPROCESSINGINSTRUCTION) RETURN VARCHAR2;
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
タグ名を指定して、すべての要素の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;
このサブプログラムは、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;
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
データの文字数を取得します。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;
このファンクションは、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;
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
属性の名前を戻します(関連項目: 「DOMAttrサブプログラム」)。
DBMS_XMLDOM.GETNAME( a IN DOMATTR) RETURN VARCHAR2;
DTDの名前、またはDOCTYPE
キーワードの直後の名前を取得します(関連項目: 「DOMDocumentTypeサブプログラム」)。
DBMS_XMLDOM.GETNAME( dt IN DOMDOCUMENTTYPE) RETURN VARCHAR2;
このファンクションは、指定した名前のノードを取得します。
このサブプログラムは、1つのプロシージャおよび2つのファンクションとしてオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
ノードに関連付けられた名前空間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;
これらのサブプログラムの操作は、各構文の実装で説明されています。
構文
このファンクションは、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);
これらのサブプログラムの操作は、各構文の実装で説明されています。
構文
このファンクションは、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);
このファンクションは、指定したノードに関連付けられたドキュメント・オブジェクトを取得します。このドキュメント・オブジェクトは、新規ノードの作成にも使用されます。指定したノードがドキュメントによってまだ使用されていないドキュメント・タイプまたはドキュメントの場合は、NULL
が戻されます。
このファンクションは、指定したノードの親を取得します。すべてのノード(Attr
、Document
、DocumentFragment
、Entity
およびNotation
を除く)は親を持つことができます。ただし、作成したノードがツリーに追加されていない場合、またはノードがツリーから削除された場合は、NULL
が戻されます。
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
指定した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;
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
DOMATTR
の修飾名を戻します(関連項目: 「DOMAttrサブプログラム」)。
DBMS_XMLDOM.GETQUALIFIEDNAME( a IN DOMATTR) RETURN VARCHAR2;
DOMElement
の修飾名を戻します(関連項目: 「DOMElementサブプログラム」)。
DBMS_XMLDOM.GETQUALIFIEDNAME( elem IN DOMELEMENT) RETURN VARCHAR2;
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
指定した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;
指定した属性がDOMELEMENT
で定義されているかどうか、またはデフォルト値が存在するかどうかをテストします。
このファンクションは、DOMIMPLEMENTATION
で特定の機能が実装されているかどうかをテストします。
このファンクションは外部のドキュメントからノードをインポートして、その新規ノードを戻します。
構文
DBMS_XMLDOM.IMPORTNODE( doc IN DOMDOCUMENT, importedNode IN DOMNODE, deep IN BOOLEAN) RETURN DOMNODE;
このファンクションは、ノードnewchild
を、既存の子ノードrefchild
の前に挿入します。refchild
がNULL
の場合、newchild
は子リストの最後に挿入されます。
newchild
がDOCUMENTFRAGMENT
オブジェクトの場合は、newchildのすべての子が同じ順序でrefchild
.の前に挿入されます。newchild
がすでにツリーに追加されている場合は、そのノードが最初に削除されます。
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
指定した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;
パラメータ
表171-94 ISNULLファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
|
チェックする |
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
マップ内の項目のうち、指定した索引(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;
このファンクションは、指定したDOMNODE
をDOMDOCUMENTFRAGMENT
に変換し、そのDOMDOCUMENTFRAGMENT
を戻します。
このファンクションはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
指定した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;
パラメータ
表171-106 MAKENODEファンクションのパラメータ
パラメータ | 説明 |
---|---|
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
|
変換する |
t |
変換する |
このファンクションは、指定したDOMNODE
をDOMPROCESSINGINSTRUCTION
に変換し、そのDomprocessinginstruction
を戻します。
このファンクションは、新規の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;
このプロシージャは、指定した名前の属性をDOMELEMENT
から削除します。
このファンクションは、指定した名前のノードをマップから削除し、そのノードを戻します。要素に添付した属性がこのマップに含まれ、削除した属性にデフォルト値があることが判明している場合、属性は、デフォルト値、対応する名前空間URI、ローカル名および接頭辞(該当する場合)とともに表示されます。
このファンクションは、子ノード・リスト内において、既存の子ノードoldchild
を新しい子ノードnewchild
で置き換え、そのoldchild
ノードを戻します。newchild
がDocumentFragment
オブジェクトの場合、oldchild
は、DocumentFragment
のすべての子ノードで置き換えられます(これらの子ノードは、DocumentFragment内と同じ順序で挿入されます)。newchild
がすでにツリーに追加されている場合は、そのノードが最初に削除されます。
このプロシージャは、ノード内の特定範囲の文字列を新しい文字列で置き換えます。正常に削除されると、データと長さに変更が反映されます。
指定した名前のDOMELEMENT
の属性値を設定します。
新規の属性ノードをDOMELEMENT
に追加します。
このプロシージャはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
インタフェースを実装するノードの文字データを設定します(関連項目: 「DOMCharacterDataサブプログラム」)。
DBMS_XMLDOM.SETDATA( cd IN DOMCHARACTERDATA, data IN VARCHAR2);
DOMPROCESSINGINSTRUCTION
のコンテンツ・データを設定します(関連項目: 「DOMProcessingInstructionサブプログラム」)。
DBMS_XMLDOM.SETDATA( pi IN DOMPROCESSINGINSTRUCTION, data IN VARCHAR2);
DOM文書の場合、このプロシージャは、指定した名前、システム識別子、および公開識別子を持つ新しいDTDを作成して、DOM文書に設定します。このDTDは、後でGETDOCTYPEファンクションを使用して取得できます。
このファンクションは、NodeName
属性に基づいてノードを追加します。指定した名前のノードがすでにマップ内に存在する場合は、そのノードは新規のノードで置き換えられます。このような置換が発生した場合は、既存のノードが戻り値となり、置換が発生しなかった場合は、NULL
が戻されます。
ノードが格納される名前は、NodeName
属性に基づいて決定されるため、特定タイプの複数のノード(特殊な文字列値を持つ複数のノード)は、名前が競合するために格納できません。このため、ノードに別名を付けることをお薦めします。
これらのサブプログラムの操作は、各構文の実装で説明されています。
構文
このファンクションは、コール元がノード値を書き込むことができる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);
これらのサブプログラムの操作は、各構文の実装で説明されています。
構文
このファンクションは、コール元がノード値を書き込むことができる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);
このファンクションは、指定された範囲のデータ(サブストリング)をノードから抽出します。
このファンクションは、ノードのデータ・タイプがRAW
またはBLOB
の場合、UTL_BINARYINPUTSTREAM
またはUTL_BINARYOUTPUTSTREAM
を使用してノード値を読取りまたは書込みできるように、TRUE
を戻します。FALSE
の値が返された場合、ノード値はUTL_CHARACTERINPUTSTREAM
またはUTL_CHARACTEROUTPUTSTREAM
でのみアクセスできます。
このプロシージャはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
データベース・キャラクタ・セットを使用して、XMLノードを指定のバッファに書き込みます(関連項目: 「DOMNodeサブプログラム」)。
DBMS_XMLDOM.WRITETOBUFFER( n IN DOMNODE, buffer IN OUT VARCHAR2);
データベース・キャラクタ・セットを使用して、XML文書を指定のバッファに書き込みます(関連項目: 「DOMDocumentサブプログラム」)。
DBMS_XMLDOM.WRITETOBUFFER( doc IN DOMDOCUMENT, buffer IN OUT VARCHAR2);
データベース・キャラクタ・セットを使用して、指定のドキュメント・フラグメントの内容をバッファに書き込みます(関連項目: 「DOMDocumentFragmentサブプログラム」)。
DBMS_XMLDOM.WRITETOBUFFER( df IN DOMDOCUMENTFRAGMENT, buffer IN OUT VARCHAR2);
このプロシージャはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
データベース・キャラクタ・セットを使用して、XMLノードを指定のCLOB
に書き込みます(関連項目: 「DOMNodeサブプログラム」)。
DBMS_XMLDOM.WRITETOCLOB( n IN DOMNODE, cl IN OUT CLOB);
データベース・キャラクタ・セットを使用して、XML文書を指定のCLOB
に書き込みます(関連項目: 「DOMDocumentサブプログラム」)。
DBMS_XMLDOM.WRITETOCLOB( doc IN DOMDOCUMENT, cl IN OUT CLOB);
このプロシージャはオーバーロードされています。各バージョンの機能と構文宣言を次に示します。
構文
データベース・キャラクタ・セットを使用して、XMLノードを指定のファイルに書き込みます(関連項目: 「DOMNodeサブプログラム」)。
DBMS_XMLDOM.WRITETOFILE( n IN DOMNODE, fileName IN VARCHAR2);
指定したキャラクタ・セットを使用して、XMLノードを指定のファイルに書き込みます。このキャラクタ・セットは、個別のパラメータとして渡されます(関連項目: 「DOMNodeサブプログラム」)。
DBMS_XMLDOM.WRITETOFILE( n IN DOMNODE, fileName IN VARCHAR2, charset IN VARCHAR2);
データベース・キャラクタ・セットを使用して、XML文書を指定のファイルに書き込みます(関連項目: 「DOMDocumentサブプログラム」)。
DBMS_XMLDOM.WRITETOFILE( doc IN DOMDOCUMENT, filename IN VARCHAR2);
指定したキャラクタ・セットを使用して、XML文書を指定のファイルに書き込みます(関連項目: 「DOMDocumentサブプログラム」)。
DBMS_XMLDOM.WRITETOFILE( doc IN DOMDOCUMENT, fileName IN VARCHAR2, charset IN VARCHAR2);