SUBSTR

SUBSTR関数は、LOBのamountバイトまたは文字（LOBで始まる絶対オフセットから計算）を返すために使用されます。

固定幅がnバイトのCLOBについて、SUBSTRの入力値が(32767/n)より大きい場合、SUBSTRは(32767/n)またはCLOBの長さ（どちらか小さい方）の長さを返します。CLOBは幅が変更可能な文字セットであるため、nはCLOBの最大バイト幅です。

構文

DBMS_LOB.SUBSTR (
lob_loc     IN    BLOB,
amount      IN    INTEGER := 32767,
offset      IN    INTEGER := 1)
RETURN RAW;

DBMS_LOB.SUBSTR (
lob_loc     IN    CLOB CHARACTER SET ANY_CS,
amount      IN    INTEGER := 32767,
offset      IN    INTEGER := 1)
RETURN VARCHAR2;

パラメータの説明

返り値

使用方法

• VARCHAR2 バッファの形式は、CLOB パラメータの形式と一致していなければなりません。つまり、入力される LOB パラメータのタイプが CLOB の場合、バッファには CHAR データを含める必要があります。

• クライアントから DBMS_LOB.SUBSTR を呼び出すと、返されるバッファにはクライアント文字セットのデータが含まれます。バッファをユーザーに返す前に、データベースはサーバー上の文字セットから LOB 値をクライアントの文字セットに変換します。

• DBMS_LOB.SUBSTR は、LOB に格納されている文字に基づいて8191文字以上を返します。文字のバイトサイズが利用可能なバッファを超えるためにすべての文字が返されない場合、ユーザーは新しいオフセットで DBMS_LOB.SUBSTR を呼び出して残りの文字を読み取るか、すべてのデータが抽出されるまでサブルーチンを繰り返し呼び出す必要があります。

• 必要に応じて、SUBSTR は読み取り前に LOB を取得します。