READ

READ ステアリングプロシージャは、LOB で始まる指定されたオフセットからデータを読み取り、buffer パラメータに返します。

amountパラメータには、実際に読み取ったバイト数または文字数が返されます。入力されたオフセットが LOB の終端を超える場合、amount は0に設定され、NO_DATA_FOUND 例外がスローされます。

構文

DBMS_LOB.READ (
lob_loc   IN             BLOB,
amount    IN OUT NOCOPY  INTEGER,
offset    IN             INTEGER,
buffer    OUT            RAW);

DBMS_LOB.READ (
lob_loc   IN             CLOB CHARACTER SET ANY_CS,
amount    IN OUT NOCOPY  INTEGER,
offset    IN             INTEGER,
buffer    OUT            VARCHAR2 CHARACTER SET ANY_CS);

パラメータの説明

異常時

使用方法

• VARCHAR2 バッファの形式は、CLOB パラメータの形式と一致している必要があります。言い換えれば、LOB パラメータに CLOB 型を指定する場合、バッファには CHAR データを含める必要があります。

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

• 必要に応じて、READ で LOB の読み取り前に LOB を取得できます。