---

Compare(OraLOB)メソッド

適用対象

OraBLOB、OraCLOBオブジェクト

OraBFILEオブジェクト

説明

OraBLOBまたはOraCLOB(またはOraBFILE)オブジェクトのLOB値の指定した部分を、OraBLOBまたはOraCLOB(またはOraBFILE)入力オブジェクトのLOB値と比較します。

使用方法

IsEqual = OraBlob.Compare srcBlob, amount, Offset, srcOffset
IsEqual = OraClob.Compare srcClob, amount, Offset, srcOffset
IsEqual = OraBfile.Compare srcBfile, amount, Offset, srcOffset

引数

このメソッドの引数は、次のとおりです。

引数	説明
[in] srcLOB	値を比較するOraBLOB、OraCLOBまたはOraBFILE入力オブジェクト。
[in] [オプション] amount	比較するバイト数または文字数を指定するInteger。amountのデフォルト値は、Offsetから各LOBの最後までの値です。
[in] [オプション] Offset	このオブジェクトの値に(1を基準とする)Offsetのバイト数(OraBLOBまたはOraBFILE)または文字数(OraCLOB)を指定するためのInteger。デフォルト値は1です。
[in] [オプション] srcOffset	srcLobオブジェクトの値に(1を基準とする)Offsetのバイト数(OraBLOBまたはOraBFILE)または文字数(OraCLOB)を指定するためのInteger。デフォルト値は1です。
[out] IsEqual	比較操作の結果を表すブール値。

備考

Compareメソッドは、比較が正常に終了するとTRUEを戻します。それ以外の場合はFALSEを戻します。

比較するバイト数または文字数が原因で、LOBの一方がその最後を超えて(他方のLOBは超えていない)比較された場合、その比較は失敗となります。この比較では、指定したOffsetから最後までのデータ量が両方のLOBで厳密に同じ場合にのみ成功となります。

このコールは現在、DBMS_LOB.INSTR()を利用するPL/SQLブロックを実行することによって実装されています。