Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

RealityV15.1Online Documentation (MoTW) Revision 7

ICONVS Function (DataBasic) (m618703+iconvs_f.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

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)