ICONVS Function

Applies an English input conversion to the elements in a dynamic array.

Syntax

ICONVS(dynArray, conversion)

Syntax Elements

dynArray A DataBasic expression that evaluates to a dynamic array.

conversion A string containing one or more English conversion codes, separated by value marks. Multiple codes are processed left-to-right, each code acting on the result produced by the previous code.

Return Value

A dynamic array with the same structure as dynArray, but with each element formatted as specified by conversion.

Comments

If the conversion is invalid or null, a run-time error is generated and ICONVS returns null.

Note

After you have called ICONVS, the STATUS function returns 0 if the conversion was valid; otherwise 2.

Examples

ARY = 1234:@VM:78.9
FMAT = "MD2"
NEWARY = ICONVS(ARY, FMAT)

Applies the MD2 conversion code to each element of dynamic array ARY; sets NEWARY to "123400VM7890" (see MD conversion code).

ARY = "29-7-09":@VM:"25-Aug-2010"
FMAT = "D"
NEWARY = ICONVS(ARY, FMAT)

Applies the D conversion code to each element of dynamic array ARY; sets NEWARY to "15186VM15578".