FMTS function

Syntax

FMTS (dynamic.array, format)
CALL -FMTS (return.array, dynamic.array, format)
CALL !FMTS (return.array, dynamic.array, format)

Description

Use the FMTS function to format elements of dynamic.array for output. Each element of the array is acted upon independently and is returned as an element in a new dynamic array.

format is an expression that evaluates to a string of formatting codes. The syntax of the format expression is:

[width] [background] justification [edit] [mask]

The format expression specifies the width of the output field, the placement of background or fill characters, line justification, editing specifications, and format masking. For complete syntax details, see the FMT function.

If dynamic.array evaluates to the null value, null is returned. If format evaluates to null, the FMTS function fails and the program terminates with a run-time error message.

If you use the subroutine syntax, the resulting dynamic array is returned as return.array.