GetChar Function
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

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



Required. Any valid String expression.


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

Exception type Error number Condition



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)

© 2015 Microsoft