Changes the length of a string to a length that you define.

NewString := PADSTR(String, Length[, FillCharacter])

Parameters

String

Type: Text constant or code

The string that you want to increase or decrease.

Length

Type: Integer

The new length of the output string.

If Length is less than the length of String, then String is truncated. Otherwise String is expanded with filler characters.

If Length is less than 0, then an error is returned.

FillCharacter

Type: Text constant or code

This is a string of length 1. This character is used to fill empty spaces at the end of the output string. If not specified, spaces are used as default. If the length of FillCharacter is not 1, an error is returned.

Property Value/Return Value

Type: Text constant or code

The output string. The length of the return value is Length characters. If the maximum (defined) length of NewString is less than Length, a run-time error occurs.

Remarks

If you omit FillCharacter and String is shorter than Length, then spaces are added at the end of String to match Length.

If you omit FillCharacter and String is longer than Length, then String is truncated.

Example

This example requires that you create the following variables and text constants in the C/AL Globals window.

Variable name DataType Length

Str1

Text

30

Str2

Text

30

Len1

Integer

Not applicable

Len2

Integer

Not applicable

Text constant ENU value

Text000

13 characters

Text001

Four

Text002

Before PADSTR is called:\

Text003

>%1< has the length %2\

Text004

>%3< has the length %4\

Text005

After PADSTR is called:\

 Copy Code
Str1 := Text000;
Str2 := Text001;
Len1 := STRLEN(Str1);
Len2 := STRLEN(Str2);
MESSAGE(Text002 + Text003 + Text004, Str1, Len1, Str2, Len2);
Str1 := PADSTR(Str1, 5); // Truncate the length to 5
Str2 := PADSTR(Str2, 15, 'w'); // Concatenate w until length = 15
Len1 := STRLEN(Str1);
Len2 := STRLEN(Str2);
MESSAGE(Text005 + Text003 + Text004, Str1, Len1, Str2, Len2);

The first message window displays the following:

Before PADSTR is called:

>13 characters< has the length 13

>Four< has the length 4

The second message window displays the following:

After PADSTR is called:

>13 ch< has the length 5

>Fourwwwwwwwwwww< has the length 15

See Also