MCGS系统内部函数参考手册

!GetProjectTotalUsers ()

函数意义：取得当前工程用户总数。 返 回 值：开关型。当前工程用户总数。 参 数：无

实 例： !GetProjectTotalUsers(),激活该函数,取得当前工程的用户总数。

字符串操作函数

!Ascii2I(s)

函数意义：返回字符串s的首字母的Ascii值。 返 回 值：开关型。 参 数：s， 字符型。

实 例：!Ascii2I(“Afd”) =65 !Bin2I(s)

函数意义：把二进制字符串转换为数值。 返 回 值：开关型。 参 数：s， 字符型。 实 例：!Bin2I(“101”) =5 !Format(n，str)

函数意义：格式化数值型数据对象 返 回 值：字符型。

参 数：n，数值型，要格式化的数值；

str，字符型，格式化数值的格式。表示为0.00样式。小数点后的0的个数表示需要格式化出的小数位数。小数点前的0为一个时，表示小数点前根据实际数值显示。当小数点前没有0时，表示为.xx式样，当小数点前的0不止一个时，使用0来填充不够的位数。

实 例：!Format(1.236，\；!Format(1.236，\； !Format(1.236，\； !Hex2I(s)

函数意义：把16进制字符串转换为数值。 返 回 值：开关型。 参 数：s， 字符型。 实 例：!Hex2I (“11”) =17

13

!I2Ascii(s)

函数意义：返回指定Ascii值的字符。 返 回 值：字符型。 参 数：s， 开关型。 实 例：!I2Ascii(65) =”A” !I2Bin(s)

函数意义：把数值转换为二进制字符串。 返 回 值：字符型。 参 数：s，开关型。 实 例：!I2Bin (5) =“101” !I2Hex(s)

函数意义：把数值转换为16进制字符串。 返 回 值：字符型。 参 数：s，开关型。 实 例：!I2Hex (17) =“11” !I2Oct(s)

函数意义：把数值转换为8进制字符串。 返 回 值：字符型。 参 数：s，开关型。 实 例：!I2Oct (9) =“11” !InStr(n，str1，str2)

函数意义：查找一字符串在另一字符串中最先出现的位置 返 回 值：数值型。

参 数：n，数值型，开始搜索的位置； str1，字符串，被搜索的字符串； str2，字符串，要搜索的字符串

实 例：!InStr(3，\，\

实 例：!InStr(1，\，\= 1,表示从str1字符串的第一个字符位置搜索str2字符串，返回最先出现的位置 !Lcase(str)

函数意义：把字符型数据对象str的所有字符转换成小写。 返 回 值：字符型。 参 数：str， 字符型。

实 例：!LCase(\

14

!Left(str，n)

函数意义：字符型数据对象str左边起，取n个字符。 返 回 值：字符型。

参 数：str：字符型，源字符串；n，数值型，取字符个数。 实 例：!Left(\，2) =\!Len(Str)

函数意义：求字符型数据对象str的字符串长度（字符个数）。 返 回 值：数值型。 参 数：str， 字符型。 实 例：!Len(\!Ltrim(str)

函数意义：把字符型数据对象str中最左边的空格剔除。 返 回 值：字符型。 参 数：str， 字符型。

实 例：!LTrim(\!lVal(str)

函数意义：将数值类字符串转化为长整型数值 返 回 值：开关型，转换出的数值。

参 数：str，字符型。要求待转换的字符串为数值类字符串 实 例：!lVal(“12345678”)=12345678 !Mid(str，n，k)

函数意义：从字符型数据对象str左边第n个字符起，取k个字符。 返 回 值：字符型。

参 数：str， 字符型，源字符串； n， 数值型，起始位置； k， 数值型，取字符数。

实 例：!Mid(\，3，2) = \!Oct2I(s)

函数意义：把8进制字符串转换为数值。 返 回 值：开关型。 参 数：s， 字符型。 实 例：!Oct2I (“11”) =9 !Right(str，n)

函数意义：从字符型数据对象str右边起，取n个字符。

15

返 回 值：字符型。

参 数：str，字符型，源字符串；n，数值型，取字符个数。 实 例：!Right(\，2) =\!Rtrim(str)

函数意义：把字符型数据对象str中最右边的空格剔除。 返 回 值：字符型。 参 数：str， 字符型。

实 例：!LTrim(\!Str(x)

函数意义：将数值型数据对象x的值转换成字符串。 返 回 值：字符型。 参 数：x， 数值型。 实 例：!Str(0.712) =\!StrComp(str1，str2)

函数意义：比较字符型数据对象str1和str2是否相等，返回值为0时相等，否则不相等。不区分大小写字母。 返 回 值：数值型。 参 数：str1， 字符型； str2， 字符型。

实 例：!StrComp(\!StrFormat(FormatStr,任意个数变量)

函数意义：格式化字符串，可以格式化任意多个数值。使用方法

为!StrFormat(“%d”,23)或!StrFormat(“%g-%g-%g”,2.3,2.1,2.2)等，类似C语言中的Printf的语法。 返 回 值：字符型。

参 数：FormatStr，字符型，格式化字符串，如：“%d”、 “%g”。后面的参数可以任意多个。

实 例：!StrFormat(\

注 意：输出多个数值时，可以使用在多个格式化字符串之间，添加分格符的方法，区别任意个数的输出变量。如：\、\。 !Trim(str)

函数意义：把字符型数据对象str中左右两端的空格剔除。 返 回 值：字符型。 参 数：str， 字符型。

16