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