DIMF

FUNCTION

This command creates a temporary string variable, with no name, of a specified length with an optional preset value for use in comparisons.

SYNTAX

DIMF(length[, value] [, ERC=n])

length: an integer that specifies the initial number of characters the temporary variable will contain. Valid values range from 0 through 64999.
value: any string whose value is repeated to the specified length. The default is the space character.
n: is a numeric value set when an error condition is produced.

NOTES

Specifying a length of 0 specifies a null string. A null string has no length and contains no data.
Make sure that the specified length is equal to the length of the data name to which the DIMF value will be compared.

EXAMPLES

IF TEST = DIMF(3,"X") THEN . . .

This example compares the TEST data name to the value specified by the DIMF command. If TEST is equal to “XXX” the comparison yields a true result.

SEE ALSO

DIM, description of DIM string function in the Thoroughbred Basic Language Reference