UniBasic Commands Reference - Rocket Software

OCONV Left Justify (ML)
Syntax
OCONV(str.expr, "MLn [f] [ [ [prefix], [thsnd_mark], [dec_symbl], [suffix] ] ] [,] [$]
[C] [Z] [(mask)]")
Description
The OCONV left justify (ML) function scales, rounds, and formats a number, or leftjustifies
it in a mask. str.expr can be any valid text or a numeric value with or without
a decimal. If the input value or conversion code is invalid, UniData returns the input
value.
Note: The OCONV ML and MR functions produce the same output. However,
formatting differs slightly in the following way: if a mask is specified that is larger
than the formatted number, UniData left- or right-justifies the number within a
“column” the width of the mask.
In BASICTYPE P, OCONV returns an empty string if UDT.OPTIONS 56 is on and the
input value or conversion code is invalid.
Parameters
The following table describes each parameter of the syntax.
Note: Some parameters set the same values. Results are unpredictable if you make
conflicting assignments.
Parameter Description
str.expr Indicates a text string or number to be left-justified and formatted.
n Sets precision (number of decimal places represented). It can be a
number from 0 through 9. If n is less than the number of decimal points
in the input data, the resulting value is rounded.
f Scales the input value num.expr by moving the decimal point f places to
the left. If omitted, f defaults to the value assigned to n (for example, if
you specify ML2, UniData reads it as ML22).
OCONV Left Justify (ML) Parameters
OCONV Left Justify (ML) 1-504