The FOPEN_NCHAR function opens a file in NCHAR mode and returns the file handle.
Applicability
This content applies only to OceanBase Database Enterprise Edition. OceanBase Database Community Edition does not support it.
Syntax
UTL_FILE.FOPEN_NCHAR (
location IN VARCHAR2,
filename IN VARCHAR2,
open_mode IN VARCHAR2,
max_linesize IN BINARY_INTEGER DEFAULT NULL)
RETURN FILE_TYPE
Parameters
Parameter |
Explanation |
|---|---|
| location | The name of the directory object where the file is located. |
| filename | File name. The file name must not contain path separators. |
| open_mode | File opening mode. NCHAR text operations user、woramode. |
| max_linesize | The maximum number of bytes per line, which ranges from 1 to 32767. The default value isNULL. |
Return value
Returns a file handle of the UTL_FILE.FILE_TYPE type.
Usage instructions
Text files opened using FOPEN_NCHAR should be read from and written to using GET_LINE_NCHAR, PUT_NCHAR, PUT_LINE_NCHAR, or PUTF_NCHAR. Passing this file handle to routine character I/O subprograms will raise a CHARSETMISMATCH exception.