Функции Asc, AscW

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращают значение Integer, предоставляющее символьный код соответствующий символу.

Public Overloads Function Asc(ByVal String As Char) As Integer
Public Overloads Function AscW(ByVal String As Char) As Integer
' -or-
Public Overloads Function Asc(ByVal String As String) As Integer
Public Overloads Function AscW(ByVal String As String) As Integer

Параметры

String
Обязательный параметр. Любое допустимое выражение Char или String. Если параметр String — выражение типа String, то в качестве входного значения используется только первый символ строки. Если String является Nothing или не содержит символов, возникает ошибка ArgumentException.

Исключения

Тип исключения	Номер ошибки	Условие
ArgumentException	5	String пуста или имеет нулевую длину.

См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок (можно сравнить номер ошибки с Свойство Number (объект Err)). Однако, по возможности, следует заменить такой контроль ошибок на Обзор структурной обработки исключений в Visual Basic.

Заметки

Функция Asc возвращает для входного символа кодовую точку или код символа. Это могут быть значения от 0 до 255 для однобайтовой кодировки (SBCS) и значения от –32768 до 32767 для двухбайтовой кодировки (DBCS).

Возвращаемое значение зависит от кодовой страницы текущего потока, которая содержится в свойстве ANSICodePage класса TextInfo в пространстве имен System.Globalization. Можно получить ANSICodePage путем указания System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

AscW возвращает кодовую точку таблицы Юникода для входного символа. Это значение может быть от 0 до 65535. Возвращаемое значение не зависит от языка и региональных параметров и параметров кодовой страницы для текущего потока.

Примечание.
Функция AscB предыдущих версий Visual Basic возвращает код для байта, вместо символа. В основном она применяется для преобразования строк в приложениях с двухбайтовой кодировкой (DBCS). Начиная с версии Visual Basic 2005, строки кодируются в Юникоде, и AscB больше не поддерживается.

Функция AscB предыдущих версий Visual Basic возвращает код для байта, вместо символа. В основном она применяется для преобразования строк в приложениях с двухбайтовой кодировкой (DBCS). Начиная с версии Visual Basic 2005, строки кодируются в Юникоде, и AscB больше не поддерживается.

Пример

В этом примере функция Asc используется для возврата кодов символов Тип данных Integer (Visual Basic), соответствующих первой букве каждой строки.

Dim codeInt As Integer
' The following line of code sets codeInt to 65.
codeInt = Asc("A")
' The following line of code sets codeInt to 97.
codeInt = Asc("a")
' The following line of code sets codeInt to 65.
codeInt = Asc("Apple")