Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Strings.Left Method

Returns a string containing a specified number of characters from the left side of a string.

Namespace:  Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

static member Left : 
        str:string * 
        Length:int -> string

Parameters

str
Type: System.String

Required. String expression from which the leftmost characters are returned.

Length
Type: System.Int32

Required. Integer expression. 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 str, the entire string is returned.

Return Value

Type: System.String
Returns a string containing a specified number of characters from the left side of a string.

ExceptionCondition
ArgumentException

Length < 0.

To determine the number of characters in str, use the Len function. If used in a Windows Forms application, or any other class that has a Left property, you must fully qualify the function with Microsoft.VisualBasic.Left.

NoteNote

The LeftB function in previous versions of Visual Basic returns a string in bytes rather than characters. It is used primarily for converting strings in double-byte character set (DBCS) applications. All current Visual Basic strings are in Unicode, and LeftB is no longer supported.

This example demonstrates the use of the Left function to return a substring of a given String. In a class that has a Left property, it may be necessary to fully qualify the Left function.

Dim TestString As String = "Hello World!" 
' Returns "Hello". 
Dim subString As String = Left(TestString, 5)

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft