Updated: 11/30/2021, 7:00:45 PM
Created: 11/30/2021, 7:00:45 PM
Last Updated By: Jake Tuttle
Read Time: 1 minute(s)

Tags: dynamic arrays

# Description

The OCONVS function converts the elements of a dynamic.array to a specified format for external output. It takes the general form:

OCONVS(dynamic.array, conversion)

Where the conversion specifies the output format specified. conversion must evaluate to one or more conversion codes separated by value marks (ASCII 253).

If multiple codes are used, they are applied from left to right as follows: the left-most conversion code is applied to the element, the next conversion code to the right is then applied to the result of the first conversion, and so on.

The output is returned in a dynamic array. If dynamic.array evaluates to null, it returns null. If any element of dynamic.array is null, it returns null for that element. If conversion evaluates to null, the OCONVS() function fails and the program terminates with a run-time error message.

The STATUS function reflects the result of the conversion:

Status Description
1 The conversion is successful.
1 Passes an invalid element to the OCONVS() function; the original element is returned. If the invalid element is null, it returns null for that element.
2 The conversion code is invalid.

# International Mode

Description of date, time, number and currency conversions when used in ICONV and International Mode.

For information about converting elements in a dynamic array to an internal format see the ICONVS function.

Go back to jBASE BASIC

Go back to Programmers' Reference Guide