Open topic with navigation

Left

Block Group:	String Operations
Icon:

The Left block returns the specified number of characters from the left end of a string.

Input/Output Properties

The following properties of the Left block can take input and give output.

• input (string)
• length (number)

input specifies the text string that contains the characters to extract.

length specifies how many characters to extract.

Output Property

The following property of the Left block can give output but cannot take input.

• output (string): Returns the extracted characters.

Special Cases

The following are special cases for the Left block:

• The length property must be greater than or equal to zero.
• If length is null, it is assumed to be zero.
• If length is greater than the length of the text, output returns the entire input

Example

In this example, the Left block extracts the leftmost five characters in "Final Price" and returns "Final."