List of Supported Functions

Supported Message Center (MC) Functions

MC Function: Atof

Format

atof( object[, decsep = '.'[, thoussep=',']] )

Arguments Types

Return Type

Returns Value

• Converts its first parameter object of type String to type Double, taking its second parameter decsep as decimal separator and its third parameter thoussep as thousands separator. If separators are indicated, then during conversion, these symbols are omitted, that is, not taken into consideration. The default value for parameter decsep is '.', for parameter thoussep – ','.

• If parameters have types other than those needed, zero (0.0) is returned.

Examples

MC Function: Atoi   

Format

atoi( object )

Arguments Types

Return Type

Returns Value

• Converts its parameter object of type String to type Integer

• If parameters have types other than those needed, zero (0) is returned

Examples

MC Function: Atol  

Format

atol( object )

Arguments Types

Return Type

Returns Value

• Converts is parameter object of type String to type Long

• Of parameters have types other than those needed, zero (0) is returned

Examples

MC Function: Convert  

Format

convert( object, p2[, p3[, p4[, p5[, p6]]]])

Arguments Types

Return Type

Returns Value

• If object is of type String, then it is returned unchanged no matter what values the other parameters include.

• If object is of type Date, then p2 must have type String representing format, according to which object is represented as string.

Examples

MC Function: CountStrings  

Format

CountStrings(countStringsObject, countStringsWhat, countStringsStart, countStringsHowMuch) 

Returns Value

Returns how many times string, specified by its 2nd parameter (countStringsWhat), occurs in the strings, specified by its 1st parameter (countStringsObject). Starting position is indicated by the 3rd parameter (countStringsStart) and the range of symbols within the search should be performed is defined by the 4th parameter (countStringsHowMuch).

Examples

MC Function: CreateVariable  

Format

CreateVariable( varName, varValue):

Returns Value

Assigns expression indicated as a second parameter (varValue) and stores it for further usage under the name that the first expression evaluates too (varName).

Examples

MC Function: CurrentTime   

Format

CurrentTime( )

Return Type

Returns Value

Returns value of type Time for the current time in the format hh:mm:ss.uuu.

Examples

MC Function: Date  

Format

Date( object,  format )

Arguments Types

Return Type

Returns Value

• Makes an attempt to convert the string that is contained in object using the format, to type Date.

• The format string can contain the following special symbols:

  • object – String

  • format – String

  • y – For year representation.

  • m – For month representation.

  • d – For day in the month representation.

• The number of consecutive special letters indicates the maximum number of digits in the corresponding area.
  For example, mm indicates that the number of the month contains at a maximum, two digits, but it can contain less too. All of this is done to enable the leading zeroes to be omitted. If any of these fields are omitted, the default values of the current date are taken. Other symbols in the format string are not taken into consideration, but the corresponding symbol must be present in the date string too. Otherwise, the date is considered to be in the incorrect format.
  For example, date('14.05.1973', 'dd/mm/yyyy') causes an error because the delimiter in the format does not match the actual one in the date ('.' instead of '/'). If the given data is an incorrect date, the object is marked as containing an invalid date.

MC Function: DayOfWeek/DayOfWeekNr/DayOfWeekShrt  

Format

dayOfWeek (dateData)
dayOfWeekNr (dateData)
dayOfWeekShrt (dateData)

Arguments Types

Return Type

Returns Value

• DayOfWeek: Returns day of week from the specified parameter of type Date.

• DayOfWeekNr: Returns day of week number from the specified parameter of type Date.

• DayOfWeekShrt: Returns day of week abbreviation from the specified parameter of type Date.

• If a parameter has a type other than what is needed, zero is returned.

MC Function: ExecuteMethod   

Format

executeMethod( methodName )

Arguments Types

Return Type

Returns Value

• Makes an attempt to execute the method specified by the string methodName. If the attempt is successful, the result of the method execution is returned, having the type and the value defined by the method of execution. If the attempt fails, stated by the message "...there is no such method…," the object of type Undefined is returned.

• If a parameter has a type other than what is needed, the object of type Undefined is returned.

Examples

MC Function: Find   

Format

find( findWhere , findWhat[, startPos = "0", [occurrence= "1"]]);

Arguments Types

Return Type

Returns Value

• Searches position of the n-the occurrence of the findWhat in findWhere beginning the position startPos, and returns the index. If where is not found, the return index is equal to -1. If start is omitted or is negative, the search is done from the beginning of findWhere. If occurrence is omitted, the first occurrence is returned.

• If parameter types differ from those needed, an empty string is returned.

Examples

MC Function: GetDay/GetMonth/GetYear   

Format

getDay(object)
getMonth(object)
getYear(object)

Arguments Types

Return Type

Returns Value

• Returns the day of the day/month/year for the object respectively.

• If a parameter has a type other than what is needed, zero is returned.

MC Function: GetDirRoot   

Format

GetDirRoot ()

Return Type

Returns Value

• Returns service root directory.

MC Function: GetLine  

Format

getLine(object[, lineNo = "1"[, pos= "1"]]);

Arguments Types

Return Type

Returns Value

• Returns the line, which number is specified in the second parameter lineNo, starting with position indicated by its third parameter pos from the original object of type String, specified by its first parameter object.

• If lineNo is omitted, or is negative, it is assumed that lineNo is equal to 1.

• If pos is omitted, or is negative, it is assumed that pos is equal to 0 (start of the string).

• If parameter types differ from those needed, an empty string is returned.

Examples

MC Function: GetLines   

Format

getLines(object[, startLine[, howMuch]]);

Arguments Types

Return Type

Returns Value

Returns SimpleString that contains at much number of lines, specified by third parameter howMuch, starting with line number specified by second parameter startLine (1 based), from the object, specified by its first parameter object.

• If startLine is omitted, or is negative, it is assumed that startLine is equal to 1.

• If startLine is bigger than the number of lines, an empty string is returned.

• If there is no line with indicated line number, lineNo, or if position pos indicates after the end of the string, an empty string is returned.

• If parameter types differ from those needed, an empty string is returned.

Examples

MC Function: GetPlatform 

Format

GetPlatform ()

Return Type

Returns Value

• Returns OS type (WIN or UNIX).

Examples

MC Function: GUID   

Format

GUID( )

Returns Value

• Returns the string type identifier for the indicated expression.

Examples

MC Function: GetTypeName   

Format

GetTypeName(expr)

Returns Value

• Returns the string type identifier for the indicated expression.

Examples

MC Function: If   

Format

IF (expression) THEN [statements_if_true;] ELSE [statements_if_false;]

Arguments Types

Return Type

Returns Value

This function conditionally executes a group of statements, depending on the value of an expression.

Examples

MC Function: Iif   

Format

iif(logexpr, result_if_true, result_if_false)

Arguments Types

Return Type

Returns Value

• Any value can be returned.

• If parameter logical_expression evaluates to true, returns second parameter result_if_true, otherwise third parameter result_if_false is returned. The second and the third parameters should (but not must) be of the same type.

• The logical expression is true only if it is:

  • Of type Date, and the date is valid,

  • Of type Time, and the time is valid,

  • Of time, String, and the string is non-empty, and

  • Of one of numeric type Integer, Double, or Long, and contains non-zero.

Examples

MC Function: IsAlpha   

Format

isAlpha(object_to_test)

Arguments Types

Return Type

Returns Value

• Returns true (non-zero) if the specified parameter (object_to_test) is alpha: consists only from letters.

• If a parameter has a type other than what is needed, zero is returned.

Examples

MC Function: IsAlphaNumeric   

Format

isAlphaNumeric(object_to_test [,separator= ","])

Arguments Types

Return Type

Returns Value

• Returns true (non-zero) if the first specified parameter (object_to_test) is alpha-numeric: consists only from letters and digits and at maximum one presence of decimal point separator (indicated by second parameter).

• If a parameter has a type other than what is needed, zero is returned.

Examples

MC Function: IsDefined   

Format

isDefined(varName)

Arguments Types

Return Type

Returns Value

• Returns true (non-zero) if the variable, indicated by its parameter varname, is defined.

• If parameters have types other than those needed, 0 (zero) is returned.

MC Function: IsNull 

Format

isNull(object)

Arguments Types

Return Type

Returns Value

• Returns true (non-zero) if the specified parameter object has type Null.

Examples

MC Function: IsNumeric  

Format

isNumeric(object_to_test[, separator= ","])

Arguments Types

Return Type

Returns Value

• Returns true (non-zero) if the first specified parameter (object_to_test) is numeric: consists only from digits and at maximum one presence of decimal point separator (indicated by second parameter).

• If a parameter has a type other than what is needed, zero is returned.

Examples

MC Function: Left  

Format

LEFT(left_object, left_howMuch)

Arguments Types

Return Type

Returns Value

• Returns left substring of its first parameter (left_object), having at much number of characters, indicated by its second parameter (left_howMuch). Attempts to convert parameters to needed types in contrast to SubString.

Examples

MC Function: Lower   

Format

Lower(object[, startPos = "0"[, howMuch = "-1"]])

Arguments Types

Return Type

Returns Value

• Changes the case of symbol to lowercase in the object, specified by its first parameter object, starting with position indicated by its second parameter startPos, and maximum number of changes, specified by its third parameter howMuch, are made.

• If startPos is omitted, or is negative, it is assumed to be equal to the start of the string.

• If howMuch is omitted, or is negative, it is assumed that all symbols must change the case.

• If parameter types differ from those needed, an empty string is returned.

Examples

MC Function: MakeNumber   

Format

MakeNumber( expr1, expr2 )

Returns Value

• This function creates the number from a specified mantissa and exponent.

MC Function: Mid   

Format

Mid( midObject, midStart, midHowMuch )

Return Type

Returns Value

• This function returns the substring of its first parameter, starting at the position specified by the first parameter. The length of the resulting string is indicated by the third parameter.

MC Function: NoOfLines   

Format

NoOfLines( expr )

Return Type

Returns Value

• The number of lines (base 1) the expression contains.

• If parameters have types other than those needed, 0 is returned.

MC Function: Nop  

Format

Nop()

Return Type

Returns Value

• The value of type Undefined is always returned.

• This is a non-operation function. It is required under certain circumstances because its execution speed is fast. It is recommended for use over other functions.

• Typically, this function is used in iif, and only when the action for one of two conditions exists.

Examples

MC Function: PadLeft  

Format

PadLeft( padObject, padChar, padMaxLen )

Return Type

Returns Value

• This function pads objects from the left side with a symbol, specified in the second parameter, so that the resulting string has at a minimum, the padMaxLen symbols.

MC Function: PadRight   

Format

PadRight( padObject, padChar, padMaxLen )

Return Type

Returns Value

• This function pads objects from the right side with a symbol, specified in the second parameter, so that the resulting string has at a minimum, the padMaxLen symbols.

MC Function: RemoveMethod   

Format

RemoveMethod( name )

Arguments Types

Return Type

Returns Value

• Makes an attempt to remove the already compiled method with a name.

• If the method was found and successfully removed, one (1) is returned. Otherwise, zero (0) is returned.

• If parameters have types other than those needed, zero (0) is returned.

MC Function: Replace   

Format

Replace( object, what, with[, from[, howMuch]] )

Arguments Types

Return Type

Returns Value

• Substitutes howMuch occurrences of the string what, with the string with, starting with position from in object. The result of the substitution is returned.

• If From is omitted, or is negative, it is assumed that its value is 0, the start of the string.

• If howMuch is omitted, or is negative, it is assumed to replace all occurrences of what with with.

• If parameter types differ from those needed, an empty string is returned.

MC Function: RFind  

Format

RFind( findWhere, FindWhat, startPos='-1', occurrence='1' )

Returns Value

• This function searches the backward position of the n-th occurrence of the second parameter in its first parameter, beginning with the position specified in its third parameter.

MC Function: Right  

Format

Right( rightObject, rightHowMuch )

Returns Value

• This function returns the right substring of its first parameter, the length of the resulting string indicated by the second parameter. If the length of the original string is less than the second parameter, the original string is returned unchanged

MC Function: SetMethod   

Format

SetMethod( name, code )

Return Type

Returns Value

• Makes an attempt to compile expression code, and if the compilation is successful, associates the compiled expression with the method name. If there is already an existing compiled expression with this name, it is overwritten. This is done only in the case where the code is different from the code of the newly compiled expression. This is to avoid having to compile the same compiled expression twice.

• Upon the successful creation of methods, one (1) is returned. Otherwise, zero (0) is returned.

• If parameters have types other than those needed, zero (0) is returned.

MC Function: StringLength  

Format

StringLength( expr )

Return Type

Returns Value

• The length of the expression expr if it is of type String. Otherwise, it returns 0.

MC Function: SubString   

Format

SubString( object, [start[, howMuch]] )

Arguments Types

Return Type

Returns Value

• Returns the substring of the string object starting with position start and containing howMuchcharacters.

• If start is omitted, or is negative, it is assumed that start is equal to 0.

• If howMuch is omitted, or is negative, howMuch is assumed to be the length of the string.

• If start is omitted, or is negative, it is assumed that start is equal to 0.

• If start+howMuch is bigger than the length of the string, all characters are taken from the position start until the end of the string.

• If parameter types differ from those needed, an empty string is returned.

MC Function: Time   

Format

Time( object, format )

Arguments Types

Return Type

Returns Value

• Makes an attempt to convert the string contained in object using the format format, to type Time.

• Format string can contain the following special symbols:

  • h – for hours representation.

  • m – for minutes representation.

  • s – for seconds representation.

• The number of consecutive special letters indicates the maximum number of digits in the corresponding area. For example, mm indicates that the number of minutes contains two digits maximum, but can still contain fewer digits. This is done to allow leading zeroes be omitted. If any of the fields are omitted, the default value (current date) is returned.

• Other symbols in the format string are not taken into consideration, but the corresponding symbol must be present in the date string too. Otherwise, the date is considered to be of incorrect format.
  For example, ('14:05:33', 'hh/mm/ss') returns an error because the delimiter in the format does not match the actual one in the date, using '.' instead of '/'. If the given data is incorrect time, the object is marked as containing invalid time.

MC Function: Today   

Format

Today()

Return Type

Returns Value

• Returns the current day value of type Date.

MC Function: Trim   

Format

Trim( object )

Arguments Types

Return Type

Returns Value

• Removes the leading and trailing blank characters from the specified string object and returns the resulting object.

• If parameter types differ from those needed, an empty string is returned.

MC Function: Upper   

Format

Upper( object[, startPos[, howMuch]] )

Arguments Types

Return Type

Returns Value

• Changes the case of the symbols in string object starting with position startPos. At a maximum, howMuchcharacters change the case.

• Removes the leading and trailing blank characters from the specified string object and returns the resulting object.

• If parameter types differ from those needed, an empty string is returned.