Strings.Right(String, Int32) Method

Reference

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 static System::String ^ Right(System::String ^ str, int Length);

public static string Right (string? str, int Length);

public static string Right (string str, int Length);

static member Right : string * int -> string

Public Function Right (str As String, Length As Integer) As String

Parameters

str: String

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

Length: 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.

Returns

String

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

Exceptions

ArgumentException

Length < 0.

Examples

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)

Remarks

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.

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.

Applies to

Jaa