Returns multiple characters from the beginning of a string.

Syntax

LEFT( string-expression, integer-expression )

Parameters

Returns

LONG VARCHAR

LONG NVARCHAR

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 argument string expression. In this case, the entire value is returned.

This function supports NCHAR inputs and/or outputs. 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]
• 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;