Go to documentation repository
Page History
...
Functions (The number of executable parameters is specified in square brackets) | General description, example use | |
MATH | ||
sin[1] | Trigonometric function: the sine of an angle. Format: y=sin(x); where y - function value, x – argument of function (in radians) Example: y=sin(1.6) Event received: Event : CORE VAR_CHANGED nt_obj_id<1>,value<0.997495>,name<y>,time<15:26:41>,date<21-09-04> | |
сos[1] | Trigonometric function: the cosine of an angle. Format: y=cos(x); where y - function value, x – argument of function(in radians) Example: y=cos(2.2) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<-0.588501>,name<y>,time<16:00:45>,date<21-09-04> | |
tan[1] | Trigonometric function, returns the tangent of an angle. Format: y=tan(x); where y - function value, x – argument of function(in radians) Example: y=tan(1) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<1.557408>,name<y>,time<16:43:45>,date<21-09-04> | |
asin[1] | Returns the arc sine of the specified numeric expression. Format: y=asin(x); where y-function value (in radians), x-argument Example: y=asin(0.5) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<0.523599>,name<y>,time<16:46:39>,date<21-09-04> | |
acos[1] | Returns the arc cosine of the specified numeric expression. Format: y=acos(x); where y-function value (in radians), x-argument Example: y=acos(0.55) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<0.988432>,name<y>,time<16:46:39>,date<21-09-04> | |
atan[1] | Returns the arc tangent of the specified numeric expression. Format: y=atan(x); where y-function value (in radians), x-argument Example: y=atan(1.2) Event received: Event : Event : CORE VAR_CHANGED int_obj_id<1>,value<0.876058>,name<y>,time<17:07:09>,date<21-09-04> | |
sinh[1] | The sinh function returns hyperbolic sine of the argument value. Format: y=sinh(x); where y - function value, x – argument of function Example: y=sinh(0.8) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<0.888106>,name<y>,time<17:12:26>,date<21-09-04> | |
сosh[1] | The cosh function returns hyperbolic cosine of the argument value. Format: y=cosh(х); where y - function value, x – argument of function Example: y=cosh(0.35) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<0.336376>,name<y>,time<17:25:25>,date<21-09-04> | |
tanh[1] | Trigonometric function of an angle. Format: y=tanh(x); where y - function value, x – argument of function Example: y=tanh(0.35) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<1.419068>,name<y>,time<17:25:25>,date<21-09-04> | |
exp[1] | Returns function value e^x, where x – specified numeric expression. Format: y=exp(x); where y-function value, x- argument Example: y=exp(1.65) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<5.20698>,name<y>,time<17:39:22>,date<21-09-04> | |
log[1] | Returns the natural logarithm (base-e) of the specified numeric expression. Format: y=log(x); where y-function value, x- argument Example: y=log(0.65) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<-0.430783>,name<y>,time<17:43:22>,date<21-09-04> | |
log10[1] | Returns the common logarithm (base-10) of the specified numeric expression. Format: y=log10(x); where y-function value, x- argument Example: y=log10(0.05) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<-1.30103>,name<y>,time<17:46:28>,date<21-09-04> | |
sqrt[1] | Returns the square root of the specified numeric expression. Format: y=sqrt(x); where y-function value, x- argument Example: y=sqrt(9) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<3>,name<y>,time<17:25:25>,date<21-09-04> | |
abs[1] | The abs function returns the absolute value of the argument. Format: y=abs(x); where y-function value, x- argument. Example: y= abs(-1) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<1>,name<y>,time<13:39:37>,date<22-09-04> | |
deg[1] | Trigonometric function of an angle. Returns the grade measure. Format: y=deg(x); where y – function value in grades, x – argument value in radians. Example: y=deg(3.14) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<179.908748>,name<y>,time<13:13:51>,date<22-09-04> | |
rad[1] | Trigonometric function of an angle. Format: y=rad(x); where y – function value in radians, x – argument value in grades. Example: y=rad(180) Event received: Event : CORE VAR_CHANGED value<3.141593>,name<y>,time<15:04:17>,date<17-03-08> | |
CONVERSION | ||
floor[1] | Integer conversion function (rounding downward). Format: x= floor(y); where x-function value, y- fraction or integer. Example: x= floor(5.55) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<5>,name<x>,time<20:51:48>,date<21-09-04> | |
ceil[1] | Integer conversion function (rounding upward). Format: x= ceil (y); where x-function value, y-fraction or integer. Example: x= ceil(5.55) Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<6>,name<x>,time<20:51:48>,date<21-09-04> | |
str[1] | Integer-to-string conversion function. Format: x=str(y); where x-function value, y-argument Example: z=(9); a=str(z); b=sqrt(a); Events received: Event : CORE VAR_CHANGED int_obj_id<1>,value<9>,name<z>,time<14:27:31>,date<22-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<9>,name<a>,time<14:27:31>,date<22-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<3>,name<b>,time<14:27:31>,date<22-09-04> | |
atof[1] | String-to-integer conversion function. Format: x=atof(y); where x-function value, y-argument Example: x="0"; x=str(atof(x)+10); Event received: Event : CORE VAR_CHANGED value<0>,name<x>,time<15:34:44>,date<17-03-08> Event : CORE VAR_CHANGED value<10>,name<x>,time<15:34:44>,date<17-03-08> | |
val[1] | Integer-to-string conversion function. Format: x=val(y); where x-function value, y-argument Example: x="10"; x=str(val(x)+2); Event received: Event : CORE VAR_CHANGED value<10>,name<x>,time<15:34:44>,date<17-03-08> Event : CORE VAR_CHANGED value<12>,name<x>,time<15:34:44>,date<17-03-08> | |
int[1] | Conversion of fraction into integer (without fractional part) Format: x=int(y); where x- function value, y- argument (fraction for conversion) Example: y=(2.33); x=int(y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<2.33>,name<y>,time<16:05:28>,date<22-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<2>,name<x>,time<16:05:28>,date<22-09-04> | |
long2time[1] | It is used to convert specified number of seconds into time. Format: x=long2time(y); where x- function value(time), y- number in seconds Format of the initial recording (argument): <MM> Format of final recording: <HH:MM:SS> Example: x=long2time(12345); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<03:25:45>,name<x>,time<13:53:02>,date<20-09-04>. | |
time2long[1] | Convert time into a number of seconds Format: x=time2 long(y); where x- value in seconds, y- time in the <hours>.<minutes>. format. Example: y=(0.15); x=time2long(y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<0.15>,name<y>,time<19:39:49>,date<22-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<900>,name<x>,time<19:39:49>,date<22-09-04> | |
scalar2date[1] | Convert a number of days into a date. (number of days is since AD) Format: x= scalar2date (y); where x-value(date), y-number of days. Example: y=(731500); x=scalar2date(y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<731500>,name<y>,time<19:57:46>,date<22-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<12-10-03>,name<x>,time<19:57:46>,date<22-09-04> | |
scalar[1] | Convert date to number of days. (The number of days is calculated AD.) Format: x=scalar(y); where x- numerical value (in days), y- date. Recording format: <DD.MM.YYYY> Example: x=scalar(“19.10.2004”) Event received: Event : CORE VAR_CHANGED int_obj_id<10>,value<731873>,owner<WS1>,name<x>,time<15:24:11>, guid_pk<{42E93AF5-4862-485E-AEF6-D14C7BF79C5B}>,date<08-12-09> | |
convert_num[1] | Convert a number into the string. Format: x=convert_num(y); where x- string value of the number, y- convertible number. Example: y=(24009921); x=convert_num(y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<24009921>,name<y>,time<12:37:20>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<Twenty four million nine thousand nine hundred twenty-one >,name<x>,time<12:37:20>,date<23-09-04> | |
convert_cur[1] | Convert a number (sum of money) into the string and add rubles and copecks. Format: x=convert_cur(y); where x- string value of the sum of money, y- number (sum of money). Recording format: <RR.KK> Example: y=(17999.98); x=convert_cur(y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<17999.98>,name<y>,time<12:49:30>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<Seventeen thousand nine hundred ninty-nine roubles ninty-eight copecks >,name<x>,time<12:49:30>,date<23-09-04> | |
FORMATTING | ||
number_frm[2] | Formatting a number Format: x=number_frm(y,z); where x-function value, y-initial number, z- number of figures after the decimal. Example: y=(17999.09998); x=number_frm(y,3); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<17999.09998>,name<y>,time<14:21:24>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<17999.100>,name<x>,time<14:21:24>,date<23-09-04> | |
int_frm[2] | Formatting number Format: x=int_frm(y,z); where x-value, y- operand, z- number of output digits. Example: y=(17999.99); x=int_frm(y,10); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<17999.99>,name<y>,time<14:31:46>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<0000017999>,name<x>,time<14:31:46>,date<23-09-04> | |
сurrency_std[1] | Formatting currency value (from '.' to '-'). Format: x=currency_std(y); where x- function value with modified format, y-number (sum of money). Example: x=currency_std(3.62); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<3-62>,name<x>,time<13:40:01>,date<23-09-04> | |
IsVarExist[1] | The function that checks a specified parameter in the event. Format: y=IsVarExist(“x”); where y - value, x – parameter If the parameter exists, then “1” returns, otherwise “0”. Example: p=IsVarExist(“param0”) Event received: Event : CORE VAR_CHANGED int_obj_id<10>,value<0>,owner<WS1>,name<p>,time<12:02:11>, guid_pk<{6A8B5BC9-919C-4098-844A-FBF78FA20820}>,date<14-12-09> | |
GetObjectIdByParam [3]
| The function that returns the first object ID found by a specified parameter. Id=GetObjectIdByParam ("x","y","z"); where id – returned value, x – object type, y – parameter, z – parameter value. Example: Id=GetObjectIdByParam("CAM","color","0"); Event received: Event : CORE VAR_CHANGED date<28-02-11>,value<2>,int_obj_id<1>,fraction<218>,name<Id>, guid_pk<{F903A28C-3243-E011-901F-6CF049E58698}>,time<15:02:04>,owner<D-IVANOV> * Id=2 (see value<2>), if the function returns empty value (value< >), then check if it and its parameters are written correctly. | |
STRING | ||
strequal[2] | Comparing strings Format: x= strequal(z,y); where x-value, z and y-compared strings. Example: z=str(1019); y=str(1019); x=strequal(z,y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<1019>,name<z>,time<16:51:45>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<1019>,name<y>,time<16:51:45>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<1>,name<x>,time<16:51:45>,date<23-09-04> * «value<1>» (see example above) – in the received event we get «value<>» - compared strings differ, or «value<1>» - compared strings are the same. | |
strsub[2] | Define if there is a substring in the string. Format: x=strsub(y,z); where x - value, y – string in which the search is performed, z-substring. Example 1: z=str(888123); y=str(123); x=strsub(z,y); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<888123>,name<z>,time<16:07:07>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<123>,name<y>,time<16:07:07>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<4>,name<x>,time<16:04:34>,date<23-09-04> Example 2: z="67hb8vc56"; y="vc"; x=strsub(z,y); Event received: Event : CORE VAR_CHANGED value<67hb8vc56>,name<z>,time<12:15:09>,date<18-03-08> Event : CORE VAR_CHANGED value<vc>,name<y>,time<12:15:09>,date<18-03-08> Event : CORE VAR_CHANGED value<6>,name<x>,time<12:15:09>,date<18-03-08> * "value<4>" (see example 1) – index in the initial string. Starting from this index the first occurrence of the substring in the string is detected. If the search result is negative, the function returns value<>. | |
strempty[1] | Define if the string is empty. Format: x=strempty(y); where x- value (1 if string is empty), y-string. Example: y=(""); x=strempty(y); Event received: Event : CORE VAR_CHANGED value< >, name<y>,time<12:27:32>,date<18-03-08> Event : CORE VAR_CHANGED value<1>,name<x>,time<12:27:32>,date<18-03-08> * function value value <> means that string is not empty. | |
straleft[2] | Left alignment Format: x=straleft(y,z); where x-aligned string, y-string, z-alignment value. Example: y=str(123456789); x=straleft(y,5); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<123456789>,name<y>,time<18:04:05>,date<23-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<12345>,name<x>,time<18:04:05>,date<23-09-04> Note. If z is bigger than the number of symbols in the string, then the function adds spaces to the initial string on the right until its length becomes z. | |
strmid[3] | Get substring Format: x=strmid(y,z,w); where x-string value, y-string, z- string position, w-substring length. Example: z=(7);//position w=(9);//length x=strmid("get substring (1 - string, 2 - position, 3 - length)",z,w); y=strmid("get substring (1 - string, 2 - position, 3 - length)",17,10); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<6>,name<z>,time<14:18:08>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<9>,name<w>,time<14:18:08>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<подстроку>value<substring>,name<x>,time<14:18:08>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<1 – string>,name<y>,time<14:18:08>,date<24-09-04> | |
strletf[2] | Get left sideofstring Format: y=strleft(s,w); where y- string value, s-string, w-length (from string beginning) Example: w=(5);//length s=("Get left sideofstring");//string y=strleft(s,w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<5>,name<w>,time<14:54:31>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value< Get left sideofstring>,name<s>,time<14:54:31>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<Get>,name<y>,time<14:54:31>,date<24-09-04> | |
strright[2] | Get right sideofstring (1 - string, 2 - length) Format: y=strleft(s,w); where y- string value, s-string, w-length (from string end) Example: w=(6);// length s=("Get right sideofstring");//string y=strright(s,w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<6>,name<w>,time<15:10:36>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value< Get right sideofstring>,name<s>,time<15:10:36>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<strings>,name<y>,time<15:10:36>,date<24-09-04> | |
strnleft[2] | Get without left sideofstring. Format: y=strnleft(s,w); where y- string value, s-string, w- length of left side that will be cut. Example: w=(6);//length s=("get without left side of string");//string y=strnleft(s,w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<6>,name<w>,time<15:32:38>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<get without left side of string>,name<s>,time<15:32:38>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<without left side of string>,name<y>,time<15:32:38>,date<24-09-04> | |
srtnright[2] | Get without right sideofstring. Format: y=strnright(s,w); where y- string value, s-string, w- length of right side that will be cut. Example: w=(6);//length s=("get without right sideofstring");//string y=strnright(s,w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<6>,name<w>,time<15:44:31>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<get without right sideofstring>,name<s>,time<15:44:31>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value< get without right side>,name<y>,time<15:44:31>,date<24-09-04> | |
get_substr[3] | Get substring (1 - string, 2 – substring to start with, 3 – substring to end with, "\r" - end of string) Format: y=get_substr(s,w,x); where y- value(substring), s-string, w- substring to start with, x- substring to end with("\r" – end of string) Recording format: <NN.NN> Example: s=("get substring 1234567890");//string w=("to");// substring to start with x=("\r");//substring to end with, "\r" - end of string y=get_substr(s,w,x); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<get substring 1234567890>,name<s>,time<16:34:13>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<по>,name<w>,time<16:34:13>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<\r>,name<x>,time<16:34:13>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<substring 1234567890>,name<y>,time<16:34:13>,date<24-09-04> Example: s=("get substring 1234567890");//string w=("to");// substring to start with x=(1);//substring to end with, "\r" - end of string y=get_substr(s,w,x); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<get substring 1234567890>,name<s>,time<16:36:26>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<по>,name<w>,time<16:36:26>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<1>,name<x>,time<16:36:26>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<substring >,name<y>,time<16:36:26>,date<24-09-04> | |
strltrim[1] | Remove spaces on the left Format: y=strltrim(w); where y- result string value, w- string. Example: w=(" remove spaces on the left");//string y=strltrim(w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value< remove spaces on the left>,name<w>,time<17:07:49>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<remove spaces on the left>,name<y>,time<17:07:49>,date<24-09-04> | |
strrtrim[1] | Remove spaces on the right Format: y=strrtrim(w); where y- result string value, w- string. Example: w=("Remove spaces on the right ");//string y=strrtrim(w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value<Remove spaces on the right >,name<w>,time<17:18:35>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<Remove spaces on the right>,name<y>,time<17:18:35>,date<24-09-04> | |
stratrim[1] | Remove spaces on both sides Format: y=stratrim(w); where y- result string value, w-string. Example: w=(" remove spaces on both sides ");//string y=stratrim(w); Event received: Event : CORE VAR_CHANGED int_obj_id<1>,value< remove spaces on both sides >,name<w>,time<17:27:44>,date<24-09-04> Event : CORE VAR_CHANGED int_obj_id<1>,value<remove spaces on both sides>,name<y>,time<17:27:44>,date<24-09-04> |
...