OVRLAY: Overlaying a Character String

OVRLAY(source_string, length, substring, sublen, position, output)

where:

source_string

Alphanumeric

Is the base character string.

stringlen

Integer

Is the number of characters in source_string and output. If this argument is less than or equal to 0, unpredictable results occur.

substring

Alphanumeric

Is the substring that will overlay source_string.

sublen

Integer

Is the number of characters in substring. If this argument is less than or equal to 0, the function returns spaces.

position

Integer

Is the position in source_string at which the overlay begins. If this argument is less than or equal to 0, the function returns spaces. If this argument is larger than stringlen, the function returns the source string.

output

Alphanumeric

Note that if the overlaid string is longer than the output field, the string is truncated to fit the field.