力控组态软件ForceControl V7.0的数学函数

Abs
语法abs(number)
说明返回number 的绝对值
参数number：实型参数或任何有效的数值表达式。
返回值与number类型相同
备注一个数的绝对值是将正负号去掉以后的值
示例ABS(-1) 和ABS(1) 都返回1

ArcCos
语法arccos (number)
说明返回number 的反余弦值
参数number 参数是一个实型数或任何有效的数值表达式。
返回值与number类型相同, 值的范围在-90 和90度之间
备注arccos函数的参数值(number) 为直角三角形两边的比值并返回以角度为
单位的角。这个比值是角的邻边长度除以角的斜边长度之商。值的范围在-90 和90度之间。
示例Arccos (1) 返回结果为0

ArcSin
语法arcsin(number)
说明返回number 的反正弦值
参数number 参数是一个实型数或任何有效的数值表达式。
返回值与number类型相同, 值的范围在-90 和90度之间
备注arcsin函数的参数值(number) 为直角三角形两边的比值并返回以角度为
单位的角。这个比值是角的对边长度除以角的斜边长度之商。
示例Arcsin(1) 返回结果为90

Arctan
语法Arctan(number)
说明返回number 的反余切值
参数number 是一个实型数或任何有效的数值表达式。
返回值与number类型相同, 值的范围在-90 和90度之间。
备注arctan 函数的参数值(number) 为直角三角形两边的比值并返回以角度为
单位的角。这个比值是角的对边长度除以角的邻边长度之商。
示例arctan (1) //返回结果为45

ArcTan2
语法atctan2(y,x)
说明求y/x的反正切值
参数x,y为任意数值
返回值返回值为-180~180
示例g = atctan (0, 0); g的值将为0；g = atctan (-1,-1); g的值将为-135；

Cos
语法Cos(number)
说明返回number 的余弦值
参数number 是实型参数或任何有效的数值表达式，以度为单位。
返回值返回值为实型, 值的范围在-1 和1之间
备注Cos 函数取一角度为参数值，并返回（直角三角形中）角的邻边长度除以
斜边长度的比值。结果的取值范围在-1 到1 之间。
示例Cos (60) //返回结果为0.5

Exp
语法Exp(number)
说明返回e 的number次方
参数实型数或任何有效的数值表达式
返回值返回值为实型，指定e（自然对数的底）的number次方
备注如果number 的值超过709.782712893，则会导致错误发生。常数e的值大
约是2.718282。Exp 函数的作用和Log 的作用互补，所以有时也称做反对
数。
示例Myvar=Exp(2.0) //返回结果为7.3891

Int
语法Int(number)
说明通过截去number小数点右边部份得到的整数
参数实型数或任何有效的数值表达式
示例Int(6.6)// 返回结果为6。
Int(-6.6)// 返回结果为-6。

力控组态软件ForceControl V7.0的变量操作函数3

SetVar
语法int SetVar(strVarName,dValue)
说明给指定数据库变量的参数赋值。
返回值int 赋值是否成功，0失败，1成功。
参数string:指定数据库变量需要赋值的参数名称。
Float:给参数要赋的数值。
示例int bRet=SetVar(“Tag0.PV”,88.3);
给变量Tag0的PV参数，赋值88.3,
操作的结果返回给bRet。

SetVarStr
语法int SetVarStr(strVarName,strValue)
说明给指定数据库变量的参数赋值。
返回值int 赋值是否成功，0失败，1成功。
参数string:指定数据库变量需要赋值的参数名称。
String:给参数要赋的字符串。
示例int bRet=SetVarStr(“Tag0.DESC”,”abcd”);
给变量Tag0的DESC参数，赋值”abcd”字符串,
操作的结果返回给bRet。

VarRedir
语法VarRedir(var, NewTagPar)
说明数据库变量重定向。用于将数据库变量或间接变量重定向，对于数据库变
量改变变量的数据库参数名称，使其指向其他数据库参数；而对于间接变
量则改变其变量指向，使其指向名字为NewTagPar的变量，该变量在
DRAW中一定要存在。通常可用于历史报表，趋势中变量动态替换。
参数var: 重定向变量，该变量必须为数据库变量或间接变量。
NewTagPar:字符串类型，新数据库参数或变量名称名称。
示例dbvar1为已定义的数据库变量。
VarRedir(dbvar1, “a1.pv”);dbvar1将指向数据库参数a1.pv
VarRedir(dbvar1, “a2.pv”);dbvar1将指向数据库参数a2.pv
VarRedir(var, “var1″);var为间接变量，var1为要转向的变量名称。

ValInputAni
语法ValInputAni（VarName,strPrompt,bPassword,bPrompt）
说明模拟量输入，调用该函数将出现一模拟输入框，通过该输入框可以修改
模拟量的值。
参数VarName：为一数值变量，输入框确认后变量的值将被修改。
strPrompt：为字符串常量或字符串表达式，bPrompt为１时．该提示信息将
被显示在输入框中。
bPassword：为一数值常量．1表示不显示输入信息，否则显示输入信息．
bPrompt：为一数值常量，表示是否出现提示信息．0表示不显示提示信
息，否则显示提示信息
示例ValInputAna(var1,”Please Input A Value”,0,1);该函数调用后将出现一模拟
输入框，提示信息为Please Input A Value．

ValInputDis
语法ValInputDis（VarName,Prompt, ONPrompt，OFFPrompt）
说明调用该函数将出现一开关选择框，通过该选择框可以修改开关量的值。
参数VarName：为一数值变量，输入框确认后改变量的值将被修改。
Prompt：为字符串常量或字符串表达式，prompt为１时．该提示信息将被显
示在输入框中。
ONPrompt：为字符串常量或字符串表达式，该提示信息将被显示在选择框状
态为真的按钮上。
OFFPrompt：为字符串常量或字符串表达式，该提示信息将被显示在选择框
状态为假的按钮上。
示例ValInputDis(var1,”Please Set Switch Status”,”ON”,”OFF”);//该函数调用后将
出现一开关选择框输入框. 信息为Please Set Switch Status,＂真＂提示信息
为ON；＂假＂提示信息为OFF。Prom8 为数值7的提示信息，该项将被显
示在选择框中的第8项中。

ValInputStr
语法ValInputStr(VarName,Prompt,password,prompt)
说明调用该函数将出现一字符输入框，通过该输入框可以修改变量的值。
参数VarName：为一字符变量，输入框确认后改变量的值将被修改。
Prompt：为字符串常量或字符串表达式。prompt为１时，该提示信息将被显
示在输入框中。
Password：为一数值常量，0表示不显示输入信息，否则显示输入信息。
Prompt：为一数值常量，表示是否出现提示信息。0表示不显示提示信息，
否则显示提示信息。
示例ValInputStr(var1,”Please Input A Value”,0,1);//该函数调用后将出现一字符输
入框，提示信息为Please Input A Value。

 

 

力控组态软件ForceControl V7.0的变量操作函数2

GetTagKind
语法int GetTagKind(“TagName”,nDataSource)
说明获取点类型，即得到点在实时数据库中的类型号
参数TagName: 点名称，字符串变量或常量。
nDataSource : 整型，数据源序号，数据源序号以0开始，注意该序号会因
数据源的删减而变动。
返回值点类型号，整型
示例KIND = GetTagKind(“FI1001”,0);

GetVar
语法float GetVar(strVarName)
说明返回指定数据库变量参数的值。
返回值float 返回数据库变量数值型参数的值。
参数string:指定数据库变量需要取值的参数名称。
示例float dVar=GetVar(“Tag0.PV”);
/ /返回Tag0的PV值，并赋给变量名为dVar的浮点型变量。

GetVarStr
语法string GetVarStr(strVarName)
说明返回指定数据库变量参数的值。
返回值string 返回数据库变量字符型型参数的值。
参数string:指定数据库变量需要取值的参数名称。
示例string strVar=GetVarStr(“Tag0.DESC”);
//返回Tag0的DESC值，并赋给变量名为strVar的字符型变量。

InsertHisData
语法sertHisData (Var, Data, Year,Month,Day,Hour,Minute,Second,Millisec)
说明向数据库中插入历史数据
参数Var: 该参数不能包含在””中。数据库变量，该变量的数据源指明了向哪个
数据库插入数据，而其数据库参数指明了是数据库的哪点参数。必须为数
值型变量。注意：要插入的值不是Var变量的当前值，而是下一个参数Data。
Data:要插入的数值，为数值型变量，常量或表达式。
参数Year,Month,Day,Hour,Minute,Second, Millisec用于指定将要插入的历史
数据发生时刻。即历史数据时间插入点。
Year :整型，表示年,范围1999～2037 。0表示当年。
Month: 整型，表示月, 范围1～12。0表示当月。
Day: 整型，表示日, 范围1～31。0表示当天，负值表示前多少天，如-1 表
示前1天，-2 表示前2天…。
Hour: 整型，表示时, 范围0～23。负值表示前多少小时，如-1 表示前1小
时，-2 表示前2小时…。
Minute: 整型， 表示分, 范围0～59。负值表示前多少分钟，如-1 表示前1
分钟，-2 表示前2分钟…。
Second:表示秒, 范围0～59。负值表示前多少秒，如-1 表示前1秒，-2 表
示前2秒…。
示例1）InsertHisData(FI101.PV,50.5,2000,12,21,10,0,0,0);//向数据库中插入的点
为FI101.PV，数值为50.5，时间为2000年12月21日10时0分0秒0毫秒。
2) InsertHisData (FI101.PV, 75.0, 0,0,-1,10,0,0,100);//向数据库中插入的点
为FI101.PV，数值为75.00, 时间为在本年本月昨日10时00分00秒100毫秒。

SetHisDataState
语法SetHisDataState（state type）
说明设置取历史数据函数的错误返回值的状态值。当调用GetHisData时如果取
值时间为不存在的值时,按照此函数的设置值返回不同的结果。
参数StateType:状态类型。
0 ： 调用GetHisData时如果取值时间为不存在的值时,返回最后的有效值
1 ： 调用GetHisData时如果取值时间为不存在的值时,返回-9999.0
2 ： 调用GetHisData时如果取值时间为不存在的值时,返回0值
备注此函数设置一次，整个运行期间的工程起作用。工程的默认值为0，如果想
修改GetHisData的返回值状态最好在每次调用前使用或者在工程启动时设
置一次。