发布时间 : 星期四 文章MCGS系统内部函数参考手册更新完毕开始阅读a9bdabd9998fcc22bcd10dd7
返 回 值：开关型。
参 数：strTarget，字符型，目标文件，需要写绝对路径； strSource，字符型，源文件，需要写绝对路径。 实 例：!FileAppend(“d:\\a.txt”,”d:\\b.txt”)
实例说明：将D盘下文件b.txt合并到文件a.txt的后面。若a.txt不存在，则会自动新建一个文件。
!FileCopy(strSource ，strTarget)
函数意义：将源文件strSource复制到目标文件strTarget，若目标文件已存在，则将目标文件覆盖。 返 回 值：开关型；
返回0，操作不成功；返回非0值，操作成功。 参 数：strSource，字符型，源文件； strTarget，字符型，目标文件。
实 例：!FileCopy(“d:\\a.txt”,”d:\\b.txt”) 实例说明：将D盘下文件a.txt复制到b.txt。 !FileDelete(strFilename)
函数意义：将strFilename指定的文件删除。 返 回 值：开关型；
返回0，操作不成功；返回非0值，操作成功。 参 数：str1，字符型，将被删除的文件。 实 例：!FileDelete(“d:\\a.txt”) 实例说明：删除将D盘下文件a.txt。
!FileFindFirst(strFilename，objName，objSize，objAttrib) 函数意义：查找第一个名字为strFilename的文件或目录。 返 回 值：开关型； 返回-1，操作不成功；
返回其它值：操作成功，返回值为一个句柄，该值为以后的查找提供根据。 参 数：strFilename，字符型，要查找的文件的文件名(文件名中可以包含文件通配符：*和?)；
objAttrib，数值型对象名，函数调用成功后，保存查找结果的属性： 若objAttrib = 0，则查找结果为一个文件； 若objAttrib = 1，则查找结果为一个目录。
objSize，数值型对象名，函数调用成功后，保存查找结果的大小； objname，字符型对象名，函数调用成功后，保存查找结果的名称。
29
实 例：!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(“d:\\a.ini”,”system”,”memory”,result) 实例说明：从配置文件a.ini中的system节中读取memory项的值，并将该值放入result数据对象中。
!FileIniWriteValue(strIniFilename，strSection，strItem，objResult) 函数意义：向配置文件（.ini文件）中写入一个值。 返 回 值：开关型。
参 数：strIniFilename，字符型，配置文件的文件名； strSection，字符型，要读取数据所在的节的名称；
30
strItem，字符型，要读取数据的项名；
objResult，数值型对象名，用于保存读到的数据；
实 例：!FileIniWriteValue(“d:\\a.ini”,”system”,”memory”,result) 实例说明：将数据对象result的值写入到配置文件a.ini中的system节中memory项中。
!FileMove(strSource，strTarget)
函数意义：将文件strSource移动并改名为strTarget。 返 回 值：开关型；
返回0：操作失败；返回非0值：操作成功。 参 数：strSource，字符型，源文件； strTarget，字符型，目标文件。
实 例：!Filemove(“d:\\a.txt”,”d:\\b.txt”)
实例说明：将D盘下文件a.txt移至同一目录下，并改名为b.txt。 注 意：如果目标文件已存在，直接返回0，操作失败。 !FileReadFields(strFilename，lPosition，任意个数变量)
函数意义：从strFilename指定的文件中读出CSV（逗号分隔变量）记录。 返 回 值：开关型。
参 数：strFilename，字符型，文件名； lPosition，数值型，数据开始位置；
实 例：!FileReadFields(“d:\\a.csv”,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(“d:\\a.dat”,100,20,abc)
实例说明：从D盘下文件a.dat中的第100个字节开始，读取20个字节的数据，结果存入字符型变量abc中。
31
!FileSplit(strSourceFile,strTargetFile, FileSize) 函数意义：此函数用于把一个文件切开为几个文件 返 回 值：开关型
参 数：strSourceFile，字符型，准备切开的文件名； strTargetFile，字符型，切开后的文件名；
FileSize，数值型，切开的文件的最大大小，单位是MB。 实 例：!FileSplit(\
实例说明：此时函数将把文件d:\\1.txt切开为大小是1MB的文件，并存放在组态软件work下，名称分别为spl000.spl,spl001.spl,spl002.spl等等 !FileWriteFields(strFilename，lPosition，任意个数变量)
函数意义：向strFilename指定的文件中写入CSV（逗号分隔变量）记录。 返 回 值：开关型。
参 数：strFilename，字符型，文件名； lPosition，开关型，数据开始位置；
= 0，表示在文件开头；<>0，表示在文件结尾；
实 例：! FileWriteFields (“d:\\a.csv”,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为0时）或结尾（当a为1时）写入一个字符串\，如果input为1时，在此字符串后面添加回车换行，否则不添加。
32