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 を取得します。