FNC_GetXMLByte - Advanced SQL Engine - Teradata Database

Teradata Vantage™ - SQL外部ルーチン プログラミング

Product
Advanced SQL Engine
Teradata Database
Release Number
17.05
17.00
Published
2020年6月
Language
日本語
Last Update
2021-03-30
dita:mapPath
ja-JP/qwr1571437338192.ditamap
dita:ditavalPath
ja-JP/qwr1571437338192.ditaval
dita:id
B035-1147
Product Category
Software
Teradata Vantage

目的

XML値をUTF-8エンコーディングでバッファに返します。

構文

void
FNC_GetXMLByte(XML_HANDLE      xmlHandle,
               byte          *xmlBuffer,
               int             xmlBufferSize,
               int           *xmlSize)
XML_HANDLE xmlHandle
外部ルーチンへの入力パラメータとして定義されたXML型へのハンドル。
byte *xmlBuffer
XML文字列を保持するバッファへのポインタ。
int xmlBufferSize
FNC_GetXMLByteに渡されるxmlBufferのバイト単位のサイズ。
int *xmlSize
FNC_GetXMLByteによって返されるXML文字列のサイズ(バイト単位)。

使用上の注意

FNC_GetXMLByteを使用して、XML型のUTF-8バイナリ エンコーディングの値を取得します。

XML_HANDLEは、バッファ(xmlBuffer)およびバッファサイズ(xmlBufferSize)へのポインタとともに入力として渡されます。xmlBufferSizeの大きさはXML値の保持に十分である必要があります。

XML値には整形式ではないXMLデータのみを含めることができることに注意してください。

FNC_GetXMLByteは、インラインXML値(64K未満のXML値)にのみ使用できます。FNC_GetXMLInfoを使用してXML値の最大長を決定できます。FNC_GetXMLByteがLOBベースのXML値と使用されると、エラーが表示されます。

例: FNC_GetXMLByteとFNC_SetXMLByteを参照してください。