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 バッファリングが有効な場合、その状態で操作を実行することはできません。 |