GetChar Function

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

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

Exceptions

Exception type	Error number	Condition
ArgumentException	5	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)