We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.

GetChar Function

Visual Studio 2008

Returns a Char value representing the character from the specified index in the supplied string.

Public Shared Function GetChar( _
   ByVal str As String, _
   ByVal Index As Integer _
) As Char


Required. Any valid String expression.


Required. Integer expression. The (1-based) index of the character in str to be returned.

Exception type

Error number




str is Nothing, Index < 1, or Index is greater than index of last character of str.

See the "Error number" column if you are upgrading Visual Basic 6.0 applications that use unstructured error handling. (You can compare the error number against the Number Property (Err Object).) However, when possible, you should consider replacing such error control with Structured Exception Handling Overview for Visual Basic.

If Index is less than 1 or greater than the index of the last character in str, an ArgumentException is thrown.

This example shows how to use the GetChar function to return a character from a specified index in a String.

Dim TestString As String = "ABCDE" 
Dim TestChar As Char 
' Returns "D"
TestChar = GetChar(TestString, 4)

Namespace: Microsoft.VisualBasic

Module: Strings

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)