XenoGuard Documentation

Pad Right

Actions » Programming » String Operation » Addendum » Pad Right 

The action Pad Right inserts a character to the right of a specified string based on a specified total length and stores the new string in Result of the result list.

[-] Hide
  1. Open the Programming node in the Workspace Explorer.
  2. Open the String Operation node.
  3. In the Addendum node, select the Pad Right action.

Parameters:

The action has the following input parameters:


NAME DESCRIPTION
String The string to be padded to the right.

Allowed Context Scopes [Fixed, Local, Global]
Allowed Context Types [Variable, Parameter, Enum]
Pad Char
A character to be inserted to the right.

Allowed Context Scopes
 [Fixed, Local, Global]
Allowed Context Types [Variable, Parameter, Enum]
Total Length
The number of characters to be inserted to the right including the length of the String parameter.

Allowed Context Scopes
 [Fixed, Local, Global]
Allowed Context Types [Variable, Parameter, Enum]

Results:

The action returns the following results:


name
description
Result Contains the new string.

Allowed Context Scopes [Fixed, Local, Global]
Allowed Context Types [Variable, Parameter]

Warning

An exception occurs when the value of the Total Length parameter is a negative number or the Pad Char is empty.

Information The Result will return the original string value if the Total Length parameter is less than or equal to the length of the String parameter.

Example 1 (Includes trailing dots to a variable):

This example adds trailing dots to the string of the local File Access variable with Text as data type. The result of the new string is then output via Write Text.

See other Addendum operations:

Insert
Concatenate
Replace
Pad Left