Description of functions

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>

cos[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>

cosh[1]

The cosh function returns hyperbolic cosine of the argument value.

Format: y=cosh(x); 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>

currency_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<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 side of string

Format: y=strleft(s,w); where y – string value, s – string, w – length (from string beginning)

Example:

w=(5);//length

s=("Get left side of string");//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 side of string>,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 side of string (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 side of string");//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 side of string>,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 side of string.

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 side of string.

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 side of string");//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 side of string>,name<s>,time<15:44:31>,date<24-09-04>

Event : CORE  VAR_CHANGED int_obj_id<1>,value< get without right side of>,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<sub>,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<sub>,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>