17.00 - 17.05 - free() - Advanced SQL Engine - Teradata Database

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

Product
Advanced SQL Engine
Teradata Database
Release Number
17.00
17.05
Published
2020年6月
Content Type
プログラミング リファレンス
Publication ID
B035-1147-170K-JPN
Language
日本語 (日本)

目的

このメソッドは、SQLXMLオブジェクトを閉じ、保持しているリソースを解放します。

構文

void free()
        throws SQLException

使用上の注意

SQL XMLオブジェクトは無効になり、このメソッドが呼び出されたときに読み取りや書き込みはできなくなります。

freeの呼び出し後に、free以外のメソッドを呼び出そうとすると、SQLExceptionがスローされます。freeが複数回呼び出されると、freeへの後続の呼び出しがno-opとして扱われます。

例外

XML値を解放しようとしたときにエラーが発生した場合、SQLExceptionをスローします。データベース固有コード"9752 (ERRUDFJAVAXML) <Failed to free XML object>"が返されます。