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です。