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）またはファイルの終わりに達するまで続行されます。
- 読み取られる内容には行終端文字自体は含まれません。
- 読み取り後、ファイルポインタは自動的に次の行の先頭に移動します。