Welcome to jBASE's new documentation site! Many answers to your questions can be found by searching the Knowledgebase or viewing the jBASE Documentation. We also have a Google Group for peer discussion about jBASE. If you are unable to find the information you are looking for, jBASE Support will be glad to assist in resolving your technical problems. Enjoy and please provide comments and feedback .

How can we help you?



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
The conversion is successful.
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.
The conversion code is invalid.


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.

Was this article helpful?