MCGS 文件资料操作函数.docx
《MCGS 文件资料操作函数.docx》由会员分享，可在线阅读，更多相关《MCGS 文件资料操作函数.docx（7页珍藏版）》请在冰豆网上搜索。
MCGS文件资料操作函数
MCGS文件操作函数
2009-08-0814:
58:
24|分类：
工业控制〔MCGS,K|标签：
|字号大中小订阅
注意：
文件操作函数中所涉与到文件的路径均为绝对路径
!
FileAppend（strTarget，strSource）
函数意义：
将文件strSource中的内容添加到文件strTarget后面，使两文件合并为一个文件。
返回值：
开关型。
参数：
strTarget，字符型，目标文件，需要写绝对路径；
strSource，字符型，源文件，需要写绝对路径。
实例：
!
FileAppend（“〞,〞〞）
实例说明：
将D盘下文件b.txt合并到文件a.txt的后面。
假如a.txt不存在，如此会自动新建一个文件。
!
FileCopy（strSource，strTarget）
函数意义：
将源文件strSource复制到目标文件strTarget，假如目标文件已存在，如此将目标文件覆盖。
返回值：
开关型；
返回0，操作不成功；
返回非0值，操作成功。
参数：
strSource，字符型，源文件；
strTarget，字符型，目标文件。
实例：
!
FileCopy（“〞,〞〞）
实例说明：
将D盘下文件a.txt复制到b.txt。
!
FileDelete（strFilename）
函数意义：
将strFilename指定的文件删除。
返回值：
开关型；
返回0，操作不成功；
返回非0值，操作成功。
参数：
str1，字符型，将被删除的文件。
实例：
!
FileDelete（“〞）
实例说明：
删除将D盘下文件a.txt。
!
FileFindFirst（strFilename，objName，objSize，objAttrib）
函数意义：
查找第一个名字为strFilename的文件或目录。
返回值：
开关型；
返回-1，操作不成功。
返回其它值：
操作成功，返回值为一个句柄，该值为以后的查找提供根据。
参数：
strFilename，字符型，要查找的文件的文件名（文件名中可以包含文件通配符：
*和?
）；
objAttrib，数值型对象名，函数调用成功后，保存查找结果的属性：
假如objAttrib=0，如此查找结果为一个文件；
假如objAttrib=1，如此查找结果为一个目录。
objSize，数值型对象名，函数调用成功后，保存查找结果的大小；
objname，字符型对象名，函数调用成功后，保存查找结果的名称。
实例：
!
FileFindFirst（“d:
\a*.txt〞,Name,Size,Attrib）
实例说明：
查找D盘下第一个名字为：
a*.txt的文件或目录，将查找结果的属性存入Attrib数值变量中，大小存入Size数值变量中，名字存入Name数值变量中。
!
FileFindNext（FindHandle,objName，objSize，objAttrib）
函数意义：
根据FindHandle提供的句柄，继续查找下一个文件或目录。
返回值：
开关型；
返回0：
查找不成功；
返回非0值：
查找成功。
参数：
FindHandle，开关型，由函数!
FileFindFirst返回。
objAttrib，数值型对象名，函数调用成功后，保存查找结果的属性：
假如objAttrib=0，如此查找结果为一个文件；
假如objAttrib=1，如此查找结果为一个目录。
objSize，数值型对象名，函数调用成功后，保存查找结果的大小；
objName，字符型对象名，函数调用成功后，保存查找结果的名称。
实例：
!
FileFindNext（aa,Name,Size,Attrib）
实例说明：
根据句柄aa，继续查找下一个文件或目录，其中，aa由函数!
FileFindFirst的返回值提供。
注意：
!
FileFindFirst（）函数与!
FileFindNext（）函数必须在同一个脚本块中编写才生效。
!
FileIniReadValue（strIniFilename，strSection，strItem，objResult）
函数意义：
从配置文件〔.ini文件〕中读取一个值。
返回值：
开关型。
参数：
strIniFilename，字符型，配置文件的文件名；
strSection，字符型，要读取数据所在的节的名称；
strItem，字符型，要读取数据的项名；
objResult，数值型对象名，用于保存读到的数据；
实例：
!
FileIniReadValue（“〞,〞system〞,〞memory〞,result）
实例说明：
从配置文件a.ini中的system节中读取memory项的值，并将该值放入result数据对象中。
!
FileIniWriteValue（strIniFilename，strSection，strItem，objResult）
函数意义：
向配置文件〔.ini文件〕中写入一个值。
返回值：
开关型。
参数：
strIniFilename，字符型，配置文件的文件名；
strSection，字符型，要读取数据所在的节的名称；
strItem，字符型，要读取数据的项名；
objResult，数值型对象名，用于保存读到的数据；
实例：
!
FileIniWriteValue（“〞,〞system〞,〞memory〞,result）
实例说明：
将数据对象result的值写入到配置文件a.ini中的system节中memory项中。
!
FileMove（strSource，strTarget）
函数意义：
将文件strSource移动并改名为strTarget。
返回值：
开关型；
返回0：
操作失败；
返回非0值：
操作成功。
参数：
strSource，字符型，源文件；
strTarget，字符型，目标文件。
实例：
!
Filemove（“〞,〞〞）
实例说明：
将D盘下文件a.txt移至同一目录下，并改名为b.txt。
注意：
如果目标文件已存在，直接返回0，操作失败。
!
FileReadFields（strFilename，lPosition，任意个数变量）
函数意义：
从strFilename指定的文件中读出CSV〔逗号分隔变量〕记录。
返回值：
开关型。
参数：
strFilename，字符型，文件名；
lPosition，数值型，数据开始位置；
实例：
!
FileReadFields（“〞,200,var1,var2,var3,var4）
实例说明：
从文件a.csv中的第200个字节开始，读取4个数据，分别存入变量：
var1,var2,var3,var4中。
!
FileReadStr（strFilename，lPosition，lLength，objResult）
函数意义：
从strFilename指定文件〔需为.dat文件〕中的lPosition，位置开始，读取lLength个字节，或一整行，并将结果保存到objResult字符型数据对象中。
返回值：
开关型
参数：
strFilename，字符型，文件名；
lPosition，开关型，数据开始位置；
lLength，开关型，要读取数据的字节数，假如小于或等于0，如此读取整行；
objResult，字符型数据对象名，用于存放结果的数据对象。
实例：
!
FileReadStr（“〞,100,20,abc）
实例说明：
从D盘下文件a.dat中的第100个字节开始，读取20个字节的数据，结果存入字符型变量abc中。
!
FileSplit（strSourceFile,strTargetFile,FileSize）
函数意义：
此函数用于把一个文件切开为几个文件
返回值：
开关型
参数：
strSourceFile，字符型，准备切开的文件名；
strTargetFile，字符型，切开后的文件名；
FileSize，数值型，切开的文件的最大大小，单位是MB。
实例：
!
FileSplit（"d:
\1.txt","Spl",1.0）
!
FileWriteFields（strFilename，lPosition，任意个数变量）
函数意义：
向strFilename指定的文件中写入CSV〔逗号分隔变量〕记录。
返回值：
开关型。
参数：
strFilename，字符型，文件名；
lPosition，开关型，数据开始位置；
=0，表示在文件开头；
<>0，表示在文件结尾；
实例：
!
FileWriteFields（“〞,200,var1,var2,var3,var4）
实例说明：
向D盘文件a.csv的文件结尾，写入4个数据，分别为变量：
var1,var2,var3,var4的值。
注意：
在文件开头写入数据时，将覆盖原有内容；在文件结尾写入数据时，将在原有根底上添加，并不覆盖原来的内容。
!
FileWriteStr（strFilename，lPosition，str，Rn）
函数意义：
向指定文件strFilename中的lPosition位置开始，写入一个字符串，或一整行。
返回值：
开关型
参数：
strFilename，字符型，文件名；
lPosition，开关型，数据开始位置；
=0，表示在文件开头；
<>0，表示在文件结尾；
str，字符型，要写入的字符串；
Rn，开关型，是否换行；
0，表示不换行；
1，表示换行；
实例：
!
FileWriteStr（"d:
\a.txt",a,"abcdefg",input）
实例说明：
在D盘下a.txt文件的开头〔当a为0时〕或结尾〔当a为1时〕写入一个字符串"abcdefg"，如果input为1时，在此字符串后面添加回车换行，否如此不添加。
注意：
在文件开头写入字符串时，将覆盖原有内容；在文件结尾写入字符串时，将在原有根底上添加，并不覆盖原来的内容。
升级会员 