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 desired 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
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
|
|
Len2
|
Integer
|
|
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