组态王命令语言函数速查手册 11
０。随着转移过程的进行，该值不断增加。当此过程成功结束时达到１００，Ｓｔａｔｕｓ被置为１。若此过程结束前发生错误，Ｓｔａｔｕｓ被置为－１。
若源文件和目的文件位于同一驱动器上，此函数可以简单地更改此文件的目录参照表（计算机在此表中保存磁盘上的文件名和存储位置），而不用实际转移任何数据。在这种情况下，不管此文件的大小，转移操作将会很快。若源文件和目的文件位于不同的驱动器上，转移操作所费的时间将随文件的大小不同而不同。这是因为数据必须由一个物理磁盘传送到另一物理磁盘上， 如：
ＦｉｌｅＭｏｖｅ（＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，＂Ｃ：＼ＢＡＣＫＵＰ＼ＤＡＴＡ．ＴＸＴ＂，Ｍｏｎｉｔｏｒ）；
将把“Ｃ”驱动器上根目录下的名为“ＤＡＴＡ．ＴＸＴ的文件转移到名为“ＢＡＣＫＵＰ”的目录下，变量 Ｍｏｎｉｔｏｒ 在转移完成后将被置为 １。
此函数也可用于文件更名，只要源文件和目的文件指定了相同的目录，但不同的文件名， 如：
ＦｉｌｅＭｏｖｅ （＂Ｃ：＼ＤＡＴＡ．ＴＸＴ＂，＂Ｃ：＼ＤＡＴＡ．ＢＡＫ＂，Ｍｏｎｉｔｏｒ）；
将把Ｃ盘根目录下文件“ＤＡＴＡ．ＴＸＴ”更名为“ＤＡＴＡ．ＢＡＫ”。变量Ｍｏｎｉｔｏｒ 在其完成后被置为１。
ＦｉｌｅＲｅａｄＦｉｅｌｄｓ
此函数从一个指定文件中读出 ＣＳＶ（逗号分隔变量）记录。调用格式：
ＦｉｌｅＲｅａｄＦｉｅｌｄｓ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，ＳｔａｒｔＴａｇ，ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ）； 参数 描述 Ｆｉｌｅｎａｍｅ 指定要读的文件。 ＦｉｌｅＯｆｆｓｅｔ 指定读此文件的起始位置。若为１，则表明
从头开始
ＳｔａｒｔＴａｇ 指定第一个数据要写到的那个组态王变量
的名称。此变量名必须以一个数字结尾（如
北京亚控自动化软件科技有限公司
12 组态王命令语言函数速查手册
ＭｙＴａｇ１）。此参数必须是一个表明变量名的
字符串（而非实际的变量本身）。所以，若变量叫做 ＭｙＴａｇ１，就需要给出ＭｙＴａｇ１或 ＭｙＴａｇ１．ｎａｍｅ，而不仅仅是ＭｙＴａｇ１。
ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ 指定要读的字段数目（此文件的每条记录中
以逗号隔开的字段的数目）。
若ＳｔａｒｔＴａｇ 为“ＭｙＴａｇ１”而ＮｕｍｂｅｒＯｆＦｉｅｌｄ为３，则有３个字段从文件中读出并保存在ＭｙＴａｇ１、ＭｙＴａｇ２和ＭｙＴａｇ３中。这些具有连续名字的变量必须先在组态王中创建，并可以属于不同的类型（整型，文字等等）。 例如：
若Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ的第一行为： “Ｔｈｉｓ ｉｓ ｔｅｘｔ， ３．１４１６， ５”，调用函数
ＢｙｔｅＰｏｓｉｔｉｏｎ＝ＦｉｌｅＲｅａｄＦｉｅｌｄｓ（＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂，１， ＂ＭｙＴａｇ１＂， ３）；
将读出此行，并把“Ｔｈｉｓ ｉｓ ｔｅｘｔ＂保存在ＭｙＴａｇ１中，３．１４１６保存在 ＭｙＴａｇ２中，５保存在 ＭｙＴａｇ３中：
此函数在读出之后返回新的字节位置。你可以在下次读时使用此返回值作为ＦｉｌｅＯｆｆｓｅｔ的值，如：
ＢｙｔｅＰｏｓｉｔｉｏｎ＝ＦｉｌｅＲｅａｄＦｉｅｌｄｓ（ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂，ＦｉｌｅＯｆｆｓｅｔ，＂ＭｙＴａｇ１＂，３）； 注意：
ＳｔａｒｔＴａｇ 两侧必须加引号。
ＦｉｌｅＲｅａｄＳｔｒ
此函数从指定文件中读出一指定数目的字节（或一整行）。调用格式：
ＦｉｌｅＲｅａｄＳｔｒ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，Ｍｅｓｓａｇｅ＿Ｔａｇ，ＣｈａｒｓＴｏＲｅａｄ）； 参数 描述 Ｆｉｌｅｎａｍｅ 指定要读的文件。 ＦｉｌｅＯｆｆｓｅｔ 指定读此文件的起始位置。若为１，则表明
从头开始。
Ｍｅｓｓａｇｅ＿Ｔａｇ 指定将从文件中读出的数据保存于何处。
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 13
指定要从文件中读出多少字节。为处理文本文件，可将ＣｈａｒｓＴｏＲｅａｄ置为０，函数从文件中一直读到下一个 ＬＦ（换行符）。
此函数在读出之后返回新的字节位置。可以在在下次读时使用此返回值作为 ＦｉｌｅＯｆｆｓｅｔ 值。 例如：
ＦｉｌｅＲｅａｄＳｔｒ （＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ＂， １， ＭｓｇＴａｇ， ０）； 文件“Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ”的第一行将被读出并保存到 ＭｓｇＴａｇ 中。
ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ
此函数往指定文件写入ＣＳＶ（逗号分隔变量）记录。调用格式：
ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，ＳｔａｒｔＴａｇ，ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ）； 参数 描述 Ｆｉｌｅｎａｍｅ 指定要写的文件。若文件不存在，则创建它。 ＦｉｌｅＯｆｆｓｅｔ 指定写此文件的起始位置。若 ＦｉｌｅＯｆｆｓｅｔ 为 ０，
此函数将写到文件末尾。若为１，则写到开头。
ＳｔａｒｔＴａｇ 指定第一个数据项的变量名称。此变量名必须以
一个数字结尾（如ＭｙＴａｇ１）。此参数必须是一个表明变量名的字符串（而非实际的变量本身）。比如，变量名为ＭｙＴａｇ１，就需要给出”ＭｙＴａｇ１”（注意引号）或ＭｙＴａｇ１．ｎａｍｅ，而不仅仅是ＭｙＴａｇ１。
ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ 指定要写的字段数目（此文件的每条记录中以逗
号隔开的字段的字段数目）。
此函数在写入之后返回新的字节位置。可以在下次调用函数时使用此返回值作为ＦｉｌｅＯｆｆｓｅｔ值。
若 ＳｔａｒｔＴａｇ为“ＭｙＴａｇ１”，而ＮｕｍｂｅｒＯｆＦｉｅｌｄｓ为３，则有３个字段被写入文件中（写入的是 ＭｙＴａｇ１、ＭｙＴａｇ２ 和 ＭｙＴａｇ３）。这些具有连续名字的变量必须先在组态王中创建，并可以属于不同的类型（整型，字符串等等）。 例如：
将一行“Ｔｈｉｓ ｉｓ ｔｅｘｔ ３．１４１６，５”写到文件Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ
北京亚控自动化软件科技有限公司
ＣｈａｒｓＴｏＲｅａｄ
14 组态王命令语言函数速查手册
的第一行中。“Ｔｈｉｓ ｉｓ ｔｅｘｔ”是 ＭｙＴａｇ１的当前值，３．１４１６
是 ＭｙＴａｇ２的当前值，５是 ＭｙＴａｇ３的当前值。调用函数
ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ （＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂， １， ＂ＭｙＴａｇ１＂， ３）；
若将文本串ＭｙＴａｇ１写到Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ的末尾，调用函数
ＦｉｌｅＷｒｉｔｅＦｉｅｌｄｓ （＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＣＳＶ＂， ０， ＂ＭｙＴａｇ１＂， ３）；
ＳｔａｒｔＴａｇ 两侧必须加引号。
ＦｉｌｅＷｒｉｔｅＳｔｒ
此函数往指定文件写入指定数目的字节（或一整行）。调用格式：
ＦｉｌｅＷｒｉｔｅＳｔｒ（Ｆｉｌｅｎａｍｅ，ＦｉｌｅＯｆｆｓｅｔ，Ｍｅｓｓａｇｅ，ＬｉｎｅＦｅｅｄ）； 参数 描述 Ｆｉｌｅｎａｍｅ 指定写入的文件。若文件不存在，则创建它。 ＦｉｌｅＯｆｆｓｅｔ 指定此文件的起始位置。若 ＦｉｌｅＯｆｆｓｅｔ 为 ０，
此函数将写到文件末尾。若为１，则写到开头
Ｍｅｓｓａｇｅ 指定要写入文件中的字符。 ＬｉｎｅＦｅｅｄ 规定是否在写操作之后添加换行。当写入一文本文件时，
可以把ＬｉｎｅＦｅｅｄ 置为１。
此函数在写入后返回新的字节位置。你可以在下次写时将此返回值当作ＦｉｌｅＯｆｆｓｅｔ（） 函数的返回值来使用。 例如：
将名为ＭｓｇＴａｇ的字符串变量写入文件Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ的末尾。调用函数ＦｉｌｅＷｒｉｔｅＳｔｒ （＂Ｃ：＼ＤＡＴＡ＼ＦＩＬＥ．ＴＸＴ＂， ０， ＭｓｇＴａｇ， １）；
ＨｉｄｅＰｉｃｔｕｒｅ
此函数用于隐藏正在显示的画面，但并不将其从内存中删除。调用格式：
ＨｉｄｅＰｉｃｔｕｒｅ（＂画面名＂）； 例如：
ＨｉｄｅＰｉｃｔｕｒｅ（＂反应车间＂）；
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 15
ＨＴＣｏｎｖｅｒｔＴｉｍｅ
此函数将指定的时间格式（年，月，日，时，分，秒）转换为以秒为单位的长整型数，转换的时间基准是１９６９年１２月３１日１６：００：００。 语法使用格式
ＨＴＣｏｎｖｅｒｔＴｉｍｅ（Ｙｅａｒ，Ｍｏｎｔｈ，Ｄａｙ，Ｈｏｕｒ，Ｍｉｎｕｔｅ，Ｓｅｃｏｎｄ）；
参数 描述 Ｙｅａｒ： 年，整型，此值必须介于１９７０和２０１９之间 Ｍｏｎｔｈ： 月，整型，此值必须介于１和１２之间 Ｄａｙ： 日，整型，此值必须介于１和３１之间 Ｈｏｕｒ： 小时，整型，此值必须介于０和２３之间 Ｍｉｎｕｔｅ： 分钟，整型，此值必须介于０和５９之间 Ｓｅｃｏｎｄ： 秒，整型，此值必须介于０和５９之间 注：
调用此函数将用年、月、日、时、分、秒表示的时间转换成自１９６９年１２月３１日１６：００：００即ＵＣＴ起到该时刻所经过的秒数 例如：
语句ＨＴＣｏｎｖｅｒｔＴｉｍｅ（１９７０，１，１，１，０，０）执行后返回长整型数为３２４００；
ＨＴＧｅｔＰｅｎＮａｍｅ
此函数返回指定趋势的指定笔号当前所用的变量名。调用格式：
ＭｅｓｓａｇｅＲｅｓｕｌｔ＝ＨＴＧｅｔＰｅｎＮａｍｅ（Ｈｉｓｔ＿Ｔａｇ ， ＰｅｎＮｕｍ）； 参数 描述
Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名称。 ＰｅｎＮｕｍ 表示笔号的整型变量或整数值（从１到８）。函数将返
回代表此指定笔的字符串变量。
例如：
用变量名Ｔｒｅｎｄ１检索趋势笔Ｐｅｎ２的变量名，并将结果放在字符串变量 ＴｒｅｎｄＰｅｎ 中。调用函数
ＴｒｅｎｄＰｅｎ＝ＨＴＧｅｔＰｅｎＮａｍｅ（Ｔｒｅｎｄ１ ， ２ ）；
北京亚控自动化软件科技有限公司