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.StringReturns a string containing a specified number of characters from the right side of a string.
| Exception | Condition |
|---|---|
| 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.
.gif?cs-save-lang=1&cs-lang=vb "Note") Note |
|---|
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)
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
