Table of contents
TOC
Collapse the table of content
Expand the table of content

Left Function

office 365 dev account|Last Updated: 6/12/2017
|
1 Contributor

Returns a Variant ( String ) containing a specified number of characters from the left side of a string. SyntaxLeft ( string, length ) The Left function syntax has thesenamed arguments:

PartDescription
stringRequired. String expression from which the leftmost characters are returned. If string containsNull, Null is returned.
lengthRequired; Variant ( Long ).Numeric expression indicating how many characters to return. If 0, a zero-length string ("") is returned. If greater than or equal to the number of characters in string, the entire string is returned.

Remarks To determine the number of characters in string, use the Len function.

Note Use the LeftB function with byte data contained in a string. Instead of specifying the number of characters to return, length specifies the number of bytes.

Example

This example uses the Left function to return a specified number of characters from the left side of a string.

Dim AnyString, MyStr
AnyString = "Hello World"    ' Define string.
MyStr = Left(AnyString, 1)    ' Returns "H".
MyStr = Left(AnyString, 7)    ' Returns "Hello W".
MyStr = Left(AnyString, 20)    ' Returns "Hello World".
© 2017 Microsoft