AYA常用函数用法说明、整理

AYA 文件操作

AYA:目录与文件操作
FENUM(dirname)：列出dirname下的存在的档案名/资料夹名，以逗号区隔并传回。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。

• FATTRIB(name):
  取得档案的属性。
  第一参数指定为档案或资料夹名称，全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
  结果返回以下的泛用阵列。分别取得0或1的值。1的时候，表示那个属性是有效的。然而，如果指定的档案不存在、处理失败的时候，返回的值不会是泛用阵列，而是单一的整数 -1 。
  ARCHIV,COMPRESSED,DIRECTORY,HIDDEN,NORMAL,OFFLINE,READONLY,SYSTEM,TEMP
  * [0] ARCHIV
  保存文件，或是保存资料夹。~
  * [1] COMPRESSED
  压缩文件，或是压缩资料夹。~
  * [2] DIRECTORY
  资料夹/目录。确认此值的话，即可分辨对象是普通的文件还是资料夹。~
  * [3] HIDDEN
  隐藏文件，或是隐藏资料夹。~
  * [4] NORMAL
  无属性。~
  * [5] OFFLINE
  这个档案现在无法使用。~
  * [6] READONLY
  唯读档。~
  * [7] SYSTEM
  Windows用档案。~
  * [8] TEMP
  暂存档。~
• FCHARSET(ID)
  指定档案写入/读取时使用的文字编码。
  文字编码清单见附录。
  请在FOPEN之前进行指定。
  可以对档案设定不同单位的文字编码。
  预设的文字编码为基础设定档案中charset项目的设定值。
  无返值。

• FOPEN(filepath,mode)
  开启档案。
  第一参数filepath为档案名称。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
  第二参数mode中对读取 / 写入的指定，如下列所示。
  "w"　或是"write"
  开启写入模式。~
  "r"　或是"read"
  开启读取模式。~
  "a"　或是"append"
  开启追加模式。 返值 0 / 1 / 2 = 失败 / 成功 / 已经开启过了。
  FCLOSE(filepath)　　[v4]
  关闭用FOPEN打开的档案。
  参数同样是FOPEN指定的档案名称。
  无返值
  注意：用FOPEN打开文件后一定要用FCLOSE关闭。
• FCOPY(oriname,topath)　　[v4]
  复制档案。
  第一参数为要拷贝的原档名、第二参数为要拷贝到的资料夹名称。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
  返值 0 / 1 = 失败 / 成功。
• FDEL(filepath)　　[v4]
  删除档案。
  全路径指定可能。相对路径的场合下以 aya5.dll load 取得的路径为基准。
  返值 0 / 1 = 失败 / 成功。
• FDIGEST　　[Tc527-1, Tc530-1追加CRC32]
  FDIGEST( path , type )对指定的档案产生杂凑值。
  杂凑值种类type如下：
  CRC32
  32bit CRC值
  MD5
  MD5值
  SHA-1 或 SHA1
  SHA-1值
  成功时返回杂凑值的16进数，失败时返回-1。
• FENUM(filepath)　　[v4]
  列举指定位置存在的档案名/资料夹名，以逗号区隔并传回。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
  资料夹的名称会在前头附加 " \ " 。
  第二参数可指定分隔符号。
• FREAD(filepath)　　[v4]
  对已开启读取模式的档案进行一行的读取。
  参数同样是FOPEN指定的档案名称。
  会自动去掉改行文字。
  到达档案终端时会传回 -1 。
• FWRITE(filepath,buff)　　[v4]
  对已开启读取模式的档案进行写入字串的动作。
  参数同样是FOPEN指定的档案名称。
  无返值。
• FWRITE2(filepath,buff)　　[v4]
  对已开启读取模式的档案进行写入字串的动作。
  参数同样是FOPEN指定的档案名称。。
  无返值。
  FWRITE会自动输入改行符号。FWRITE2不会。
• FMOVE　　[v4]
  移动档案。
  第一参数为移动对象的档名、第二参数为移动对象的资料夹名。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
  返值 0 / 1 = 失败 / 成功。
• FRENAME　　[v4]
  变更档案名称。
  第一参数为对象档名、第二参数为新的档名。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
  返值 0 / 1 = 失败 / 成功。

AYA:打开文件和进行读写操作实例
//read data
filepath='text.txt';
_f=FOPEN(filepath,'r');
_buff=FREAD(filepath);
FCLOSE(filepath);

//write data
filepath='text.txt';
_f=FOPEN(filepath,'w');
FWRITE(filepath,'hello');
FCLOSE(filepath);

//append data
filepath='text.txt';
_f=FOPEN(filepath,'a');
FWRITE(filepath,'hello');
FCLOSE(filepath);

AYA:文件创建操作
MKDIR(folder)　　[v4]
作成资料夹。全路径指定可能。相对路径的场合下以 DLL load 取得的路径为基准。
只能作成一阶层。
返值 0 / 1 = 失败 / 成功。

AYA:文件创建实例
//创建文件夹
if FATTRIB("profile") == -1 {
_temp=MKDIR("profile");
}

//创建文件
FCHARSET(1);
if FOPEN("test.txt",'r') == 0 {
_t = FOPEN("text.txt",'w');
}
FCHARSET(1);