Export (0) Print
Expand All

Strings.Right Method

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

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

'Declaration
Public Shared Function Right ( _
	str As String, _
	Length As Integer _
) As String

Parameters

str
Type: System.String

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

Length
Type: System.Int32

Required. Integer. 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 right 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 Form, or any other class that has a Right property, you must fully qualify the function with Microsoft.VisualBasic.Strings.Right.

NoteNote

The RightB function in earlier 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 RightB is no longer supported.

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

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

.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