Returns a number of characters from the beginning of a string.

Syntax

LEFT( string-expression, integer-expression )

Parameters

Remarks

If the string contains multibyte characters, and the proper collation is being used, the number of bytes returned may be greater than the specified number of characters.

You can specify an integer-expression that is larger than the value in the column. In this case, the entire value is returned.

Whenever possible, if the input string uses character length semantics the return value will be described in terms of character length semantics.

See also

• RIGHT function [String]
• UltraLite string functions

Standards and compatibility

Example

The following statement returns the first 5 characters of each Surname value in the Customers table.

SELECT LEFT( Surname, 5) FROM Customers;