昆仑通态脚本开发函数 下载本文

实例说明:获取时间值iTime中的分钟。

!TimeGetDay(iTime)

函数意义:获取时间值iTime中的日期。

返 回 值:整型,时间值iTime中的日期(1~31)。 参 数:iTime,整型,时间值。 实 例:!TimeGetDay (iTime)。

实例说明:获取时间值iTime中的日期。

!TimeGetCurrentTime()

函数意义:获取当前时间值。 返 回 值:整型,当前的时间值。 参 数:无。

实 例:!TimeGetCurrentTime()。 实例说明:获取当前时间值。

!TimeSpanGetDays(iTimeSpan) 函数意义:获取时间差中的天数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的天数(1~31)。 参 数:iTimeSpan,整型,时间差。 实 例:!TimeSpanGetDays(TimeSpan)。 实例说明:获取时间差TimeSpan中的天数。

!TimeSpanGetHours(iTimeSpan)

函数意义:获取时间差中的小时数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的小时数(0~23)。 参 数:iTimeSpan,整型,时间差。 实 例:!TimeSpanGetHours(TimeSpan)。 实例说明:获取时间差TimeSpan中的小时数。

!TimeSpanGetMinutes(iTimeSpan) 函数意义:获取时间差中的分钟数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的分钟数(0~59)。 参 数:iTimeSpan,整型,时间差。

实 例:!TimeSpanGetMinutes(TimeSpan)。 实例说明:获取时间差TimeSpan中的分钟数。

!TimeSpanGetSeconds(iTimeSpan) 函数意义:获取时间差中的秒数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的秒数(0~59)。 参 数:iTimeSpan,整型,时间差。

实 例:!TimeSpanGetSeconds(TimeSpan)。 实例说明:获取时间差TimeSpan中的秒数。

!TimeSpanGetTotalHours(iTimeSpan) 函数意义:获取时间差中的小时总数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的小时总数。 参 数:iTimeSpan,整型,时间差。

实 例:!TimeSpanGetTotalHours(TimeSpan)。 实例说明:获取时间差TimeSpan中的小时总数。

!TimeSpanGetTotalMinutes(iTimeSpan) 函数意义:获取时间差中的分钟总数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的分钟总数。 参 数:iTimeSpan,整型,时间差。

实 例:!TimeSpanGetTotalMinutes(TimeSpan)。 实例说明:获取时间差TimeSpan中的分钟总数。

!TimeSpanGetTotalSeconds(iTimeSpan) 函数意义:获取时间差中的秒总数;(时间差由TimeGetSpan函数计算得来)。 返 回 值:整型,时间差中的秒总数。 参 数:iTimeSpan,整型,时间差。

实 例:!TimeSpanGetTotalSeconds(TimeSpan)。 实例说明:获取时间差TimeSpan中的秒总数。

!TimeAdd(iTime,iTimeSpan)

函数意义:向时间iTime中加入由iTimeSpan指定的秒数。 返 回 值:整型,相加后的时间值。 参 数:iTime,整型,初始时间值。 iTimeSpan,整型,要加的秒数。 实 例:!TimeAdd(Time,500)。

实例说明:向时间Time中加上500秒。

!Str2ByteArr(str,ByRef ByteArr)

函数意义:将字符串str中的所有字符填入字节数组,字节数组位置计数从1开始。

返 回 值:整型,返回值0表示填充成功,-1表示字符串中字符的长度大于字节数组的长度,

超出部分已经被裁剪;-2 表示不是字节数组,-3 表示操作失败。 参 数:str,字符型,需填充的字符串。 ByteArr,传址型,类型为字节型数组,被填充的字节数组。

实 例:!Str2ByteArr(\,其中BA为字节数组,BA中的数据为:\、\、\、\、\,

从第6个字节开始的数据未知。

!ByteArr2Str(ByRef ByteArr, str, count)

函数意义:将字节数组ByteArr中的前Count个字节的数据填入字符串中。 返 回 值:0 成功, -1 失败。

参 数:ByteArr,传址型,字节型数组。

Str,传址型,取得的字符串。 Count,整型,由字节数组填充而形成的字符串。

实 例:! ByteArr2Str (BA,str, 5),其中BA为字节数组,BA中的数据为:\、\、\、\、\,

则生成了一个长度为5的字符串 str :“ABCDE”。

!SetIntToByteArr(ByRef ByteArr,start,n)

函数意义:对字节数组ByteArr中从start位置开始的内容进行填充,填充的长度为4字节,填充的内容为n,

按4字节整型进行填充,字节数组位置计数从1开始。 返 回 值:整型,判断是填充是否正常: 0: 正常; -1: start的值小于1; -2: start的值大于字节数组的长度; -3: 填充后的结果的某些位置超出ByteArr的长度; -4: 不是字节数组。 -5: 操作失败。

参 数:ByteArr,传址型,字节型数组,被填充的字节数组。 start,整型,填充的首位置,从1开始。 n,整型,填充的内容

实 例:!SetIntToByteArr (BA,1, 65),则形成的字节数组为: 65 00 00 00

!SetShortToByteArr(ByRef ByteArr,start,n)

函数意义:对字节数组ByteArr中从start位置开始的内容进行填充,填充的长度为2字节,填充的内容为n,

按2字节整型进行填充,所以这种填充方式要求n的值范围为: -32767 ≤ n ≤ 32768。

字节数组位置计数从1开始。 返 回 值:整型,判断是填充是否正常: 0: 正常; -1: start的值小于1; -2: start的值大于字节数组的长度; -3: 填充后的结果的某些位置超出ByteArr的长度; -4: 其它错误。

参 数:ByteArr,传址型,字节型数组,被填充的字节数组。 start,整型,填充的首位置,从1开始。 n,整型,填充的内容

实 例:! SetShortToByteArr (BA,1, 65),则形成的字节数组为: 65 00

!SetStrToByteArr(ByRef ByteArr,start,str)

函数意义:对字节数组ByteArr中从start位置开始的内容进行填充,填充的长度为字符串str的长度字节,

填充的内容为字符串str,字节数组位置计数从1开始。 返 回 值:整型,判断是填充是否正常:

0: 正常; -1: start的值小于1; -2: start的值大于字节数组的长度; -3: 填充后的结果的某些位置超出ByteArr的长度; -4: 填充后的长度。

参 数:ByteArr,传址型,字节型数组,被填充的字节数组。 start,整型,填充的首位置,从1开始。 str,字符型,填充的内容

实 例:!SetStrToByteArr (BA,2, \,则形成的字节数组为: \ \

!SetSingleToByteArr(ByRef ByteArr,start,x)

函数意义:对字节数组ByteArr中从start位置开始的内容进行填充,填充的长度为4,填充的内容为浮点型x,

填充的格式按照BASIC中单精度浮点型格式填充,字节数组位置计数从1开始。

返 回 值:整型,判断是填充是否正常: 0: 正常; -1: start的值小于1; -2: start的值大于字节数组的长度; -3: 填充后的结果的某些位置超出ByteArr的长度; -4: 其他错误。

参 数:ByteArr,传址型,字节型数组,被填充的字节数组。 start,整型,填充的首位置,从1开始。 x,数值型,填充的内容

实 例:!SetSingleToByteArr (BA,1, 12.3 ),则形成的字节数组的前四个字节为BASIC中单精度浮点数的内部表示。

!GetIntFromByteArr(ByRef ByteArr,start,ByRef n)

函数意义:将字节数组ByteArr中从start位置开始的内容输出到变量n中,输出的格式为4字节整型,

字节数组位置计数从1开始。 返 回 值:整型,判断是输出是否正常: 0: 正常; -1: start的值小于1; -2: start的值大于字节数组的长度; -3: ByteArr无足够多的内容用以输出; -4: 变量n不能够用于保存数据,或空间长度不够 -5: 其他错误。

参 数:ByteArr,传址型,字节型数组。 start,整型,输出的首位置,从1开始。 n,传址型,长整型; 实 例:!GetIntFromByteArr (BA,2, A),字节数组为:00 01 02 03 04 05 06 07 08 09 00 00 则A=67305985