FOPEN_NCHAR 関数は、NCHARモードでファイルを開くために使用されます。
機能の適用範囲
この内容はOceanBaseデータベースEnterprise Editionにのみ適用されます。OceanBaseデータベースCommunity Editionは現在サポートされていません。
構文
UTL_FILE.FOPEN_NCHAR (
location IN VARCHAR2,
filename IN VARCHAR2,
open_mode IN VARCHAR2,
max_linesize IN BINARY_INTEGER
) RETURN FILE_TYPE;
パラメータの説明
パラメータ |
説明 |
|---|---|
| location | 開くファイルのパスオブジェクト名。 |
| filename | 開くファイル名。ファイル名には「/」を含めることはできません。 |
| open_mode | ファイルの開き方を指定します。モードは以下のとおりです:
open_mode に a または ab を指定してもファイルが存在しない場合、そのファイルは write モードで作成されます。 |
| max_linesize | このファイルの各行の最大バイト数です。改行文字も含みます。[1,32767] の範囲で、デフォルト値は1024です。 |
戻り値
関数は UTL_FILE.FILE_TYPE 型のファイルハンドルを返します。その後、このファイルに対するすべての読み書き操作ではこのハンドルを使用する必要があります。
使用方法
- 通常の
FOPEN関数とは異なり、FOPEN_NCHARはUnicodeモードでファイルを開くために特化しています。この関数でファイルを開いた後、そのファイルに対する読み書き操作はデータベースのデフォルト文字セットではなく、Unicode文字セットを使用します。これにより、異なる言語環境間でワイド文字データを正しく格納および読み取ることが保証されます。 UTL_FILEパッケージ(FOPEN_NCHARを含む)を使用してオペレーティングシステムのファイルを操作する前に、データベース内に対応するDIRECTORYオブジェクトを作成し、該当するユーザーにそのディレクトリへの読み書き権限を付与する必要があります。