This section describes functions that are used to perform conversions between different types.

The following functions for Type Conversion described here are:

Converts a bytearray to a big integer (two complement).

void baToBigInt
 (bigint bigintVar,
 bytearray baValue)

Converts a bytearray to a string containing the hexadecimal values.

string baToHexString(bytearray baValue)

Converts a bytearray to a string.

string baToStr
 (bytearray array,
 string charEncoding) //Optional

Converts a date to a string and assigns the result to a string variable (or field). Returns true if the conversion succeeded. The only time the conversion can fail, is if the date is null or the format is invalid.

boolean dateToString
 (string stringVar,
 date dateValue,
 string format) //optional

Converts a string to a bytearray and assigns the result to a bytearray variable (or field).

void strToBA
 (bytearray array,
 string stringValue,
 string charEncoding) //Optional

Converts a string to a big integer. If the conversion was successful true is returned.

If one of the keywords dec or hex are specified, the string is assumed to be decimal or hexadecimal respectively. Decimal is the default.

boolean strToBigInt
 (bigint bigintVar,
 string stringValue, 
 dec|hex) //Optional

Converts a string to a date and assigns the result to a date variable (or field). Returns true if the conversion succeeded.

You can enable lenient interpretation of the date/time in the string to be converted by setting the Cell property mz.drdate.lenient to true in the cell.conf. With lenient interpretation, a date such as "January 32, 2016" will be treated as being equivalent to the 31nd day after January 1, 2016. With strict (non-lenient) interpretation, an invalid date will cause the function to leave the submitted date variable unchanged. The default value of mz.drdate.lenient is false.

boolean strToDate
 (date dateVar,
 string stringValue,
 string format, //Optional 
 string timeZone) //Optional

$ mzsh topo set topo://container:<container>/pico:<pico name>/val:config.properties.mz.use.drdateformat false

$ mzsh topo set topo://container:<container>/pico:<pico name>/obj:config.jvmargs \
'usercountry: ["-Duser.country=US"]
userlanguage: ["-Duser.language=en"]'

Converts a decimal string to a double and assigns the result to a double variable (or field). Returns true if the conversion succeeded.

boolean strToDouble
 (double doubleVar,
 string stringValue)

Converts a decimal string to a float and assigns the result to a float variable (or field). Returns true if the conversion succeeded.

boolean strToFloat
 (float floatVar,
 string stringValue)

Converts a decimal or hexadecimal string to an integer and assigns the result to an integer variable (or field). Returns true if the conversion succeeded.

If one of the keywords dec or hex are specified, the string is assumed to be decimal or hexadecimal respectively. Decimal is the default.

boolean strToInt
 (int intVar,
 string stringValue, 
 dec|hex) //Optional

int a;
int b;
strToInt( a, CallTime, hex );
strToInt( b, "12345" ); /* dec is default */

Converts a decimal or hexadecimal string to a long and assigns the result to an long variable (or field). Returns true if the conversion succeeded.

If one of the keywords dec or hex are specified, the string is assumed to be decimal or hexadecimal respectively. Decimal is the default.

boolean strToLong
 (long longVar,
 string stringValue, 
 dec|hex) //Optional

boolean strToBigDec
 (bigdec bigdecVar,
 string stringValue)

Converts a UDR to a string. Each UDR will be preceded with the internal class name, and each of its field will be preceded with the field name.

string udrToString(drudr myUDR)

Field values for: 
<internal UDR reference>
field1: <value>
field2: <value>