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