GETLENGTH関数は、指定されたLOBの長さを取得するために使用されます。返される長さはバイトまたは文字単位です。
長さのカウントには、以前のWRITEなどの操作によって生成されたLOB内の0バイトまたはスペースも含まれます。空の内部LOBの長さは0です。
適用対象
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity EditionはMySQLモードのみを提供します。
構文
DBMS_LOB.GETLENGTH (
lob_loc IN BLOB
)
RETURN NUMBER;
DBMS_LOB.GETLENGTH (
lob_loc IN CLOB CHARACTER SET ANY_CS
)
RETURN NUMBER;
パラメータの説明
| パラメータ | 説明 |
|---|---|
| lob_loc | LOBのロケーターです。DBMS_LOB使用方法を参照してください。 |
戻り値
LOBの長さ(バイトまたは文字)は整数(INTEGER)です。入力LOBがNULLであるか、入力lob_locがNULLである場合、NULL返します。
例外
| 例外 | 説明 |
|---|---|
| BUFFERING_ENABLED | LOB上でバッファリングが有効になっている場合、LOBバッファリングが有効な状態で操作を実行することはできません。 |