# 功能介绍

### 枚举、结构体及部分类型数据说明

ATTRIB

枚举变量，定义了文件的特征，用于给GetAttribute功能块提供返回值

ERROR

枚举变量，整个库中可能出现的故障定义

MODE

枚举变量，定义了Open功能块中，文件打开的方式

FILE_DIR_ENTRY

结构体变量，保存了目录下每个条目的信息，通过顺序调用DirList来填写

T_FILENAME

TYPE T_FILENAME: STRING(255)

T_HANDLE

TYPE T_HANDLE: ULINT

T_SIZE

TYPE T_SIZE : UDINT

T_PVOID

TYPE T_PVOID: ULINT

### 目录类(Directory)

DirOpen

打开一个目录，返回的句柄后续使用的时候都需要用到，如果需要获得目录内的条目，需要调用DirList，一个一个获得

DirClose

关闭一个目录

DirList

读取目录条目，每次读取一条，读取的内容存储在结构体中

DirCreate

创建一个子目录

DirCopy

拷贝目录，可以通过参数指定是否拷贝子目录或者是否覆盖

DirRename

重命名一个目录（不建议用此功能移动文件，可以使用Rename）

DirRemove

删除一个目录（可能有文件已经被Open打开）

### 文件类(File)

FileOpen

打开一个文件，生成一个句柄，可以用于Read、Write、Close（xExclusive参数codesys不支持）

FileClose

关闭文件句柄

FileRead

读取数据到buffer中

FileWrite

将buffer写入文件中

FileCopy

拷贝文件，如果不存在则创建，存在根据参数可以选择覆盖

FileDelete

删除文件，如果Open也会被删除

FileRename

重命名文件，也可以用于移动文件，不能用于移动目录

FileSetPos

移动当前打开文件的读写位置

FileGetPos

读取当前打开文件的读写位置

FileEOF

用于判断当前读写位置是否已经到文件末尾

FileFlush

强制将缓冲区内的数据写入到磁盘中

FileGetAttribute

获得当前打开文件的文件属性，文件属性的定义位于枚举变量ATTRIB

FileGetSize

获取文件名指向文件的文件大小

FileGetTime

获取文件名指向文件的最新修改日期

函数类 GetLibVersion

功能描述：返回当前版本信息

Return：（VERSION）返回当前版本信息