|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|
Asc, AscW Functions
Returns an Integer value representing the character code corresponding to a character.
Public Overloads Function Asc(ByVal String As Char) As Integer Public Overloads Function AscW(ByVal String As Char) As Integer
Public Overloads Function Asc(ByVal String As String) As Integer Public Overloads Function AscW(ByVal String As String) As Integer
- Required. Any valid Char or String expression. If String is a String expression, only the first character of the string is used for input. If String is Nothing or contains no characters, an ArgumentException error occurs.
|Exception type||Error number||Condition|
|ArgumentException||5||String is not specified or is zero length.|
Asc returns the code point, or character code, for the input character. This can be 0 through 255 for single-byte character set (SBCS) values and -32768 through 32767 for double-byte character set (DBCS) values. The returned value depends on the code page for the current thread, which is contained in the ANSICodePage property of the TextInfo class. TextInfo.ANSICodePage can be obtained by specifying System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.
AscW returns the Unicode code point for the input character. This can be 0 through 65535. The returned value is independent of the culture and code page settings for the current thread.
Note The AscB function of earlier versions of Visual Basic returns a code for a byte, rather than a character. It is used primarily for converting strings in double-byte character set (DBCS) applications. All Visual Basic .NET strings are in Unicode, and AscB is no longer supported.
This example uses the Asc function to return Integer character codes corresponding to the first letter in each string.
Dim MyInt As Integer MyInt = Asc("A") ' MyInt is set to 65. MyInt = Asc("a") ' MyInt is set to 97. MyInt = Asc("Apple") ' MyInt is set to 65.
Assembly: Microsoft Visual Basic .NET Runtime (in Microsoft.VisualBasic.dll)