Oracle基础包UTL_FILE

一、概述

作用:
用于读写OS文件.使用该包访问OS文件时,必须要为OS目录建立相应的DIRECTORY对象…当用户要访问特定目录下的文件时,必须要具有读写DIRECTORY对象的权限.在使用UTL_FILE包之前,应首先建立DIRECTORY对象.

二、包的组成

1.file_type

作用：
该类型是utl_file包中所定义的记录类型，其成员是私有的，不能被直接引用。
该类型的定义如下：
type file_type is record(is binary_integer,datatype binary_integer);

2.fopen

作用：
用于打开OS文件。注意，使用该函数最多可以同时打开50个文件
语法：

file_type.fopen(
location in varchar2,filename in varchar2,
open_mode in varchar2,max_linesize in binary_integer) return file_type;
--当成功执行后会返回文件句柄，访问该文件可以直接使用文件句柄。
--如果执行失败会触发异常或显示错误。注意当指定文件位置时必须要使用directory对象，且其名称必须大写。

3.fopen_nchar

作用：
用于以unicode方式打开文件。当使用该函数打开文件后，读写文件会使用unicode取代数据库字符集。
语法：

utl_file.fopen_nchar(
location in varchar2,
filename in varchar2,
open_mode in varchar2
max_linesize in binary_integer) return file_type;

4.is_open

作用：
用于确定文件是否已经打开
语法：

utl_file.is_open(file in file_type) return boolean;
其中file指定文件句柄，如果文件已经被打开返回true，否则返回false。

5.fclose

作用：
用于关闭已经打开的文件
语法：

utl_file.fclose(file in out file_type);

6.fclose_all

作用：
用于关闭当前会话打开的所有文件
语法：

utl_file.fclose_all;

7.get_line

作用：
用于从已打开文件中读取行内容，行内容会被读取到输出缓冲区
语法：

utl_file.get_line(file in file_type,buffer out varchar2,
linesize in number,len in pls_integer default null);
--其中buffer用于存储读取信息，linesize指定要读取的最大字节输，len指定实际读取长度。

8.get_line_nchar

作用：
用于以unicode方式读取已打开文件的行内容，并且将行内容读取到输出缓冲区。
语法：

utl_file.get_line_nchar(file in file_type,buffer out varchar2,
len in pls_integer default null);

9.get_raw

作用：
用于从文件中读取raw字符串，并调节文件指针到读取位置。
语法：

utl_file.get_raw(fid in utl_file.file_type,r out nocopy raw,
len in pls_integer default null);

10.put

作用：
用于将缓冲区内容写入到文件中，当使用put过程时文件必须要以写方式打开。
在写入缓冲区内容后如果要结束行，可以用new_line过程。

语法：

utl_file.put(file in file_type,buffer in varchar2);

11.put_nchar

作用：
用于将缓冲区内容以unicode方式写入到文件。
语法：

utl_file.put_nchar(file in file_type,buffer in varchar2);

12.put_raw

作用：
用于将raw缓冲区中的数据写入到OS文件。
语法：

utl_file.put_raw(fid in utl_file.file_type,r in raw,
autoflush in boolean default false);
--其中fid指定文件句柄，r指定存放raw数据的缓冲区，autoflush指定是否要自动刷新缓冲区数据。

13.new_line

作用：
用于为文件增加行终止符。
语法：

utl_file.new_line(file in file_type,lines in natural:=1);
--其中lines指定要增加的行终止符个数。

14.put_line

作用：
用于将文本缓冲区内容写入到文件中。当使用该过程为文本追加内容时会自动在内容的尾部追加终止符。
语法：

utl_file.put_line(file in file_type,buffer in varchar2,
autoflush in boolean default false);

15.put_line_nchar

作用：
用于将文本缓冲区内容以unicode方式写入文件。自动在尾部追加终止符。
语法：

utl_file.put_line_nchar(file in file_type,buffer in varchar2);

16.putf

作用：
用于以特定格式将文本内容写入到OS文件，其中格式符%s表示字符串，格式符\n表示行终止符。
语法：

utl_file.putf(file in file_type,format in varchar2
[arg1 in varchar2 default null,...arg5 in varchar2 default null]);
--其中format指定格式符（最多5个%s），arg1...arg5指定对应格式符的字符串。

17.putf_nchar

作用：
用于以特定格式将文本内容以unicode的方式写入到OS文件，其中格式符%s表示字符串，格式符\n表示行终止符。
语法：

utl_file.putf_nchar(file in file_type,format in varchar2
[,arg1 in varchar2 default null,...arg5 in varchar2 default null]);
--其中format指定格式符（最多5个%s），arg1...arg5指定对应格式符的字符串。

18.fflush

作用：
用于将数据强制性写入到OS文件。正常情况下当给文件写入数据时，
数据会被暂时存放在缓冲中，过程fflush用于强制将数据写入到OS文件中。
语法：

utl_file.fflush(file in file_type);

19.fseek

作用：
用于移动文件指针到特定位置。既可以指定文件指针的绝对位置，也可以指定文件指针的相对位置。
语法：

utl_file.fseek(
fid in utl_file.file_type,absolute_offset in pl_integer default null,
relative_offset in pls_integer default null);
--其中absolute_offset指定文件指针的绝对位置(单位：字节)，
--relative_offset指定文件指针的相对位置（单位：字节）。

20.fremove

作用：
用于删除磁盘文件
语法：

utl_file.fremove(location in varchar2,filename in varchar2);
--其中location指定directory对象（必须大写），filename指定要删除的OS文件名。

21.fcopy

作用：
用于将源文件的全部或部分内容复制到目标文件中。如果不设置起始行和结束行则复制文件所有内容。
语法：

utl_file.fcopy(location ni varcahr2,
filename in varchar2,
dest_dir in varchar2,
dest_file in varchar2,
start_line in pls_integer default 1,
end_line in pls_integer default null);
--其中location指定源文件所在目录对应的directory对象，filename指定源文件名，
--dest_dir指定目标文件所在目录对应的directory对象，dest_file指定目标文件的名字，
--start_line指定起始行号，end_line指定结束行号。

例子：

exec utl_file.fcopy('USER_DIR','a.txr','USER_DIR','c.txt');

22.fgetpos

作用：
返回文件指针所在的偏移位置。

语法：

utl_file.fgetpos(fileid in file_type) return pls_integer;

23.fgetattr

作用：
用于读取磁盘文件，并返回文件属性

语法：

utl_file.fgetattr(location in varchar2,filename in varchar2,
exists out boolean,file_length out number,blocksize out number)
--其中location指定OS目录所对应的directory对象，filename指定OS文件名，
--exists确定文件是否存在，file_length取得文件长度，blocksize取得OS块的尺寸。

24.frename

作用：
用于修改已存在的OS文件名，其作用与unix的mv命令完全相同。
在修改文件名时，通过指定overwrite参数，可以覆盖已存在的文件。

语法：

utl_file.frename(location in varchar2,filename in varchar2,dest_dir in varchar2,
dest_file in varchar2,overwrite in boolean default false);
--其中overwrite指定是否要覆盖已存在文件(false:不能覆盖，true:覆盖)。

例子：

exec utl_file.frename('USER_DIR','d.txt','USER_DIR','c.txt');