ESLSTR Function

Create a string by padding characters to the front or rear of an input string.

PadStringFunction(INPUT_STRING_SV, PAD_CHAR_SV, FRONT_OR_REAR_IV, PAD_SIZE_IV)

INTPUT_STRING_SV

The identifier for the input string.

PAD_CHAR_SV

The character you want to use to pad the new string.

FRONT_OR_REAR_IV

Either 0 (pad the front of the string) or 1 (pad the end of the string).

PAD_SIZE_IV

An integer indicating the resulting size of the new string.

Description

Use this function to add a number of pad characters (PAD_CHAR_SV) to either the front (0) or rear (1) of created string until it reaches the number specified in PAD_SIZE_SV. The function returns a string that has been padded to the specified size. If the input string is longer than the specified size, the input string is merely copied. If there is an error; either a NULL string is returned or the string will contain "-1\n".