GET_LINE_NCHARは、Unicodeモードでテキストファイルから1行の内容を読み取るために使用されます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity Editionは現在サポートされていません。
構文
UTL_FILE.GET_LINE_NCHAR (
file IN UTL_FILE.FILE_TYPE,
buffer OUT NVARCHAR2,
len IN PLS_INTEGER DEFAULT NULL
);
パラメータの説明
パラメータ |
説明 |
|---|---|
| file | 読み取るファイルのファイルハンドルです。このファイルは少なくとも r モードで開かれている必要があります。 |
| buffer | 読み取ったデータを格納するための出力パラメータです。この文字列の長さが別のパラメータ len より長いことを確認してください。 |
| len | 読み取るデータのバイト数です。指定しない場合、システムはファイルを開いたときのパラメータ max_linesize を使用して指定します。 |
使用方法
- 1回の呼び出しで1行を読み取ります。現在のファイルポインタの位置から始まり、行終端文字（オペレーティングシステムが決定する、例えば \n または \r\n）またはファイルの終わりに達するまで続行します。
- 読み取られた内容には行終端文字自体は含まれません。
- 読み取り後、ファイルポインタは自動的に次の行の先頭に移動します。