XMLROOT

構文

図「xmlroot.gif」の説明

用途

XMLROOTでは、既存のXML値のXMLルート情報(プロローグ)のバージョンとスタンドアロンのプロパティを指定して、新しいXML値を作成できます。value_exprがすでにプロローグを持っている場合、エラーが戻されます。入力がNULLの場合、このファンクションはNULLを戻します。

戻り値は次の書式になります。

<?xml version = "version" [ STANDALONE = "{yes | no}" ]?>

• 最初のvalue_exprでは、XML値を指定します。この値に対してプロローグ情報を指定します。

• VERSION句のvalue_exprは、有効なXMLバージョンを表す文字列である必要があります。VERSIONにNO VALUEを指定すると、バージョンはデフォルトで1.0になります。

• オプションのSTANDALONE句を指定しない場合や、NO VALUEを指定した場合は、ファンクションの戻り値にスタンドアロンのプロパティは存在しません。

例

次の文は、DUAL表を使用して、XMLROOTの構文を示します。

SELECT XMLROOT ( XMLType('<poid>143598</poid>'), VERSION '1.0', STANDALONE YES)
   AS "XMLROOT" FROM DUAL;

XMLROOT
--------------------------------------------------------------------------------
<?xml version="1.0" standalone="yes"?>
<poid>143598</poid>