GET_LINE

GET_LINE ストアドプロシージャは、入力されたファイルハンドルと読み取り長さに基づき、ファイルが最後に読み取られたオフセットから指定された長さのデータを読み取ります。改行文字に遭遇すると停止します。

構文

UTL_FILE.GET_LINE (
file           IN    FILE_TYPE,
buffer         OUT   VARCHAR2,
len            IN    PLS_INTEGER DEFAULT NULL);

パラメータの説明

例外状況

• INVALID_FILEHANDLE

• INVALID_OPERATION

• NO_DATA_FOUND

• READ_ERROR

使用方法

• ファイルは r モードで開く必要があります。そうでない場合、INVALID_OPERATION 例外が発生します。

• 行をバッファに収納できない場合、READ_ERROR 例外が発生します。ファイル終端でテキストが読み取れない場合、NO_DATA_FOUND 例外が発生します。ファイルをバイトモードで開いた場合、INVALID_OPERATION 例外が発生します。

• 行終端文字がバッファに読み込まれないため、空行を読むと空文字列が返されます。

• FOPEN で最大バイト数が指定されていない場合、バッファの最大サイズは32767バイトです。デフォルト値は1024です。