The ICONVS function converts each element of a dynamic array to a specified internal storage format.



ICONVS(dynamic array, conversion)



conversion is an expression that evaluates to one or more valid conversion codes, separated by value marks (ASCII 253).


Each element of dynamic.array is converted to the internal format specified by conversion and is returned in a dynamic array. If multiple codes are used, they are applied from left to right. The first conversion code converts the value of each element of dynamic.array. The second conversion code converts the value of each element of the output of the first conversion, and so on. If dynamic.array evaluates to null, it returns null. If an element of dynamic.array is null, null it returns null for that element. If conversion evaluates to null, the ICONV function fails and the program terminates with a run-time error message.

The STATUS function reflects the result of the conversion:

For information about converting elements in a dynamic array to an external format

See also: OCONVS function.

0 The conversion is successful.

1 An element of dynamic.array is invalid. It returns an empty string, unless dynamic.array is null, in which case it returns null.

2 Conversion is invalid.

3 Successful conversion of possibly invalid data.