Num：数值型时间值，单位：小时。 实 例：! DelAlmDat(电机温度，1.2)，删除数据对象“电机温度”对应的报警存盘
数据中最早 1.2 小时内的数据。
!DelAllAlmDat(DatName)
函数意义：删除数据对象 DatName 对应的所有报警存储数据。如 DatName=空字符， 则删除所有对象对应的所有报警存储数据。
!GetWindowName(Index)
函数意义：按用户窗口的顺序获得用户窗口的名字。 返 回 值：字符型。 参 数：Index, 数值型。 实 例：!GetWindowName(0) ，读取 0 号用户窗口的名称。
!SetWindow(WndName,Op)
函数意义：按照名字操作用户窗口，如打开、关闭、打印。 返 回 值：数值型。返回值：=0：调用正常。<>0：调用不正常。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。 参 数：DatName：数据对象名，字符型。
FileName：新的报警存盘文件名(包括路径)，字符型。 Num1：数值型时间量，单位：小时。本函数用 Num1<0 的一些数值来表 示一些特殊意义的操作（此时 Num2 无效）： =-1 转存当天的所有报警信息存盘数据； =-2 转存昨天的所有报警信息存盘数据； =-3 转存本星期的所有报警信息存盘数据； =-4 转存上星期的所有报警信息存盘数据；
!GetDeviceName(Index)
函数意义：按设备顺序取到设备的名字。 返 回 值：字符型。调用成功返回设备名，调用失败时返回空字符串。 参 数：Index，数值型。 实 例：!GetDeviceName(0) ，取 0 号设备构件的名称。
5.5 策略操作函数
!GetStgyName(Index)
函数意义：应答数据对象 DataName 所产生的报警，如 DatName=空字符，则所有数据 对象所产生的报警。如对应的数据对象没有报警产生或已经应答，则本函 数无效。
返 回 值：无。 参 数：DatName：数据对象名，字符型； 实 例：!AnswerAlm(电机温度)，应答数据对象“电机温度”所产生的报警。
5.2 字符操作函数
!Left(str,n)
函数意义：字符型数据对象 str 左边起，取 n 个字符。 返 回 值：字符型。 参 数：str：字符型，源字符串；n，数值型，取字符个数。 实 例：!Left("ABCDEFG",2) ="AB"
!Right(str,n)
函数意义：从字符型数据对象 str 右边起，取 n 个字符。 返 回 值：字符型。 参 数：str，字符型，源字符串；n，数值型，取字符个数。 实 例：!Right("ABCDEFG",2) ="FG"
!Exp(x)
函数意义：指数函数。 返 回 值：数值型。 参 数：x，数值型。 实 例：!Exp(2.3020585093)=10.0
!Log(x)
函数意义：对数函数。 返 回 值：数值型。 参 数：x，数值型。 实 例：!Log(10)=2.302
!Sqr(x)
函数意义：平方函数。 返 回 值：数值型。 参 数：x，数值型。 实 例 ：!Sqr(2.0)=4.0
!Trim(str)
函数意义：把字符型数据对象 str 中左右两端的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") ="dsfk"
!StrComp(str1,str2)
函数意义：比较字符型数据对象 str1 和 str2 是否相等，返回值为 0 时相。等，否则不 相等。不分大小写字符。
!GetEventT(EvName)
函数意义：取到当前事件产生的时间，以秒为单位，相对于 1980 年以来的秒数。如没 有事件产生，返回-1。
返 回 值：数值型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventT(EvName)，取事件型变量 EvName 的当前事件产生时刻。
!DelAlmDat(DatName,Num)
函数意义：删除数据对象 DataName 对应的报警存储数据中最早 Num 小时内的报警存 储数据，如 Num<=0 或 DatName=空字符，则该函数无效。
返 回 值：数值型，返回值=0：调用正常，<>0：调用不正常。 参 数：DatName：数据对象名，字符型；
函数意义：按设备名查询设备的状态。 返 回 值：数值型。
=-1 调用不正常。 =1 设备处于正常的工作状态。 =2 设备正在工作，但设备不正常。 =3 设备处于停止工作状态，且设备正常。 =4 设备处于停止状态，且设备有错。 参 数：DevName，设备名，字符型。 实 例：!GetDeviceState( OmronPLC)，读取设备构件“OmronPLC”的当前工作状态。
5.6 事件操作函数
!GetEventdT(EvName)
函数意义：返回当前事件和上一次事件之间的时间差，单位为秒。 返 回 值：数值型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventdT(EvName)，取事件变量 EvName 当前事件和上一次事件之间的
时间差，单位为秒。
!GetEventP(EvName)
函数意义：取到当前事件的附加说明字符串。 返 回 值：字符型。 参 数：EvName，事件变量名，字符型。 实 例：!GetEventP(EvName) ，取事件型变量 EvName 的当前事件的附加说明字符
串。
5.7 报警操作函数
!AnswerAlm(DatName)
=-5 转存本月的所有报警信息存盘数据； =-6 转存上个月的所有报警信息存盘数据； Num2：数值型时间量，单位：小时。 Flag：转存标志，数值型。Flag=0 时，创建一个新文件(如原文件已存在， 则把原文件改名为***.BK1)；Flag=1 时，在原有的基础上增加新的数据。 实 例：!MoveAlmDat(电机温度, "D:\Temp\ttt.mdb"，-6，0，1)，把数据对象“电机 温度”对应的报警存盘数据中的上个月的所有报警信息存盘数据转存添加 到数据库文件当"D:\Temp\ttt.mdb"中。
参 数：WndName, 用户窗口名, 字符型。Op: 操作户窗口的方法，数值型。 Op=1：打开窗口并使其可见。 Op=2：打开窗口并使其不可见。 Op=3：关闭窗口。 Op=4：打印窗口。
实 例：!SetWindow(工况图,1)，打开用户窗口“工况图”，并使其可见。
5.4 设备操作函数
!GetDeviceState(DevName)
返 回 值：数值型。 参 数：str1, 字符型；
str2, 字符型。 实 例：!StrComp("ABC", "abc") = 0
!Val(str)
函数意义：把字符型数据对象 str 的值转换成数值。 返 回 值：数值型。 参 数：str, 字符型。 实 例：!Val("0.712") = 0.712
!Str(x)
函数意义：将数值型数据对象 x 的值转换成字符串。 返 回 值：字符型。 参 数：x, 数值型。 实 例：!Str(0.712) ="0.712"
5.3 窗口操作函数
!GetWindowState(WndName)
函数意义：按照名字取得用户窗口的状态。 返 回 值：数值型。
返回 0：用户窗口处于关闭状态。 返回 1：用户窗口处于打开状态。 返回 2：用户窗口处于隐藏状态。 参 数：WndName，用户窗口名称，字符型。 实 例：!GetWindowState(工况图)，读取用户窗口“工况图”的状态
第五章 MCGS 系统内部函数
MCGS 内部为用户提供了一些常用的数学函数和对 MCGS 内部有关对象操作的函数， 组态时，可在表达式中或用户脚本程序中直接使用这些函数。为了与其它名称相区别，系统 内部函数的名称一律以“！”符号开头。下面分别介绍各个函数的用途和用法。
5.1 数学函数
!Atn(x)
函数意义：反正切函数。 返 回 值：数值型，用弧度表示。 参 数：x，数值型。 实 例：!Atn(1) =0.785398
!Ltrim(str)
函数意义：把字符型数据对象 str 中最左边的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") = "dsfk "
!Rtrim(str)
函数意义：把字符型数据对象 str 中最右边的空格剔除。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LTrim(" dsfk ") =" dsfk"
!Cos(x)
函数意义：余弦函数。 返 回 值：数值型。 参 数：x，数值型，用弧度表示。 实 例：!Cos(3.14159)=-1.0
!Sin(x)
函数意义：正弦函数。 返 回 值：数值型。 参 数：x，数值型，用弧度表示。 实 例：!Sin(3.14159)=0.0
!Tan(x)
函数意义：正切函数。 返 回 值：数值型。 参 数：x，数值型，用弧度表示。 实 例：!Tan(3.14159)=0.0
!Ucase(str)
函数意义：把字符型数据对象 str 的所有字符转换成大写。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!UCase("sedERT") ="SEDERT"
!Lcase(str)
函数意义：把字符型数据对象 str 的所有字符转换成小写。 返 回 值：字符型。 参 数：str, 字符型。 实 例：!LCase("sedERT") = "sedert"