epsynall参考手册库函数说明.doc

EpSynall 的库函数本章主旨: ?讲解调用系统内部函数的方法?内部函数使用说明 EpSynall 的库函数 I- 2 调用内部函数的方法第一步:在定义命令语言对话框中单击“内部函数”按键,弹出函数列表对话框。如图 所示: 图 选择函数第二步:选择函数在“函数名称列表”框中选择要使用的函数, 并单击确定。弹出如图 所示的对话框: 图 设置函数参数第三步:设置函数参数在图 中的“函数输入变量类型”列表框中选中参数类型, 并在“函数输入变量名”编辑框中输入变量或参数。所有参数设置完成后确定, 设置完成。?请尝试这样做:在‘函数列表’对话框中选择 HideWindow 函数并确定(如图 ), 然后在‘函数输入’对话框中设置函数参数” test ”(即: 窗口名) EpSynall 的库函数 I- 3 如图 所示并确定退出,此时你会看到如图 的画面。图 . 3 在后台语言中添加 HideWindow 函数 内部函数的调用格式(按字母查询) EPSYNALL 提供了许多复杂的内部函数,其中包括字符串函数、数学函数、系统函数、控件函数以及其它类型的函数。下面介绍各函数的调用格式: ?注: 在示例中 Dim 表示在组态系统数据词典中定义的变量。 字符串函数 1. ftostr 函数此函数将一实数值转换成字符串形式。语法: ftostr (Real,Number1,Number2 ) 参数描述: Real 根据 Number1 和 Number2 转换成字符串形式,该参数可包含任何有效的数值表达式。 Number 1 指定 Real 值的位数,包括整数位数和小数位数,不含小数点。 Number 2 指定 Real 值的小数位数, 该参数为零时, 输出的字符串中无小数部分。返回值: 该函数返回代表一数值的字符串,返回值为消息类型。?示例: EpSynall 的库函数 I- 4 本示例使用 ftostr 函数将一个实型变量转成字符串。 Dim MyString (消息类型)、 Float (浮点型)、 Int (整型) Float=; Int=-72; MyString = ftostr ( Float,5,3 ); 返回" "。 MyString = ftostr ( Float,5,0 ); 返回" 612 "。 MyString = ftostr ( Int,2,0 ); 返回" -72 "。 2. FindSubStr 函数此函数用于查找指定字符子串在字符串中的位置(位置从 0 开始)。语法: FindSubStr (SourceStr,SearchStr ) 参数描述: SourceStr 用于查找 SearchStr 位置的字符串,若 SourceStr 中包含多个 SearchStr 子串,则返回其出现的第一个位置。 SearchStr 指定要查找的字符子串。返回值: 该函数返回字符子串在字符串中的第一个位置, 返回值为整型。若返回值为-1 则表示字符串中不包含被查找的子串。?示例: 本示例使用 FindSubStr 函数查找子串在字符串中的位置( 区分大小写)。 Dim SourceStr, SearchStr (消息类型) Dim NumResult (整型,取值范围-1~65535 ) 1) SourceStr= ” windows drow ”; SearchStr= ” ow ”; NumResult= FindSubStr(SourceStr,SearchStr); 返回 4。 2) SourceStr= ” windows ”; SearchStr= ” dos ”; NumResult= FindSubStr(SourceStr,SearchStr); 返回-1。 3) SourceStr= ” Windows ”; SearchStr= ”w”; NumResult= FindSubStr(SourceStr,SearchStr); 返回 5。 4) SourceStr= ” Windows ”; SearchStr= ” Win ”; NumResult= FindSubStr(SourceStr,SearchStr); 返回 0。 3. ltodate 函数此函数将表示时间的整数转换为日期字符串。语法: ltodate (nTime,nType ) 参数描述: nTime 表示时间的长整数, 用户可通过全局变量“$ 时间值”获得表示当前 EpSynall 的库函数 I- 5 时间的长整数值。 nType 指定返回的日期字符串的格式。 0: 对应格式“*