Функция StrComp (Visual Basic)
Обновлен: Ноябрь 2007
Возвращает -1, 0 или 1 в зависимости от результата сравнения строк.
Public Shared Function StrComp( _
ByVal String1 As String, _
ByVal String2 As String, _
<Microsoft.VisualBasic.OptionCompareAttribute> _
Optional ByVal Compare As Microsoft.VisualBasic.CompareMethod _
) As Integer
Параметры
String1
Обязательно. Любое допустимое String выражение.String2
Обязательно. Любое допустимое String выражение.Compare
Необязательно. Указывает тип сравнения строк. Если Compare опущен, то тип сравнения определяется параметром Option Compare.
Параметры
Аргумент Compare принимает следующие значения:
Константа |
Описание |
|---|---|
Binary |
Выполняет двоичное сравнение, основанное на порядке сортировки, полученном из внутренних двоичных представлений знаков. |
Text |
Выполняет сравнение текста, основываясь на порядке сортировки текста с учетом регистра, определенном текущими сведениями о языковых и региональных параметрах. |
Возвращаемое значение
Функция StrComp имеет следующие возвращаемые значения:
Если |
StrComp возвращает |
|---|---|
String1 при сортировке помещается перед String2 |
-1 |
Значение параметра String1 равно значению параметра String2. |
0 |
String1 при сортировке помещается после String2 |
1 |
Исключения
Тип исключения |
Номер ошибки |
Условие |
|---|---|---|
Недопустимое значение параметра Compare. |
См. столбец "Номер ошибки", если выполняется обновление приложений Visual Basic 6.0, в которых используется неструктурированная обработка ошибок. (Можно сравнить номер ошибки с Свойство Number (объект Err).) Однако, по возможности, следует заменять такую систему управления ошибками на Обзор структурной обработки исключений в Visual Basic.
Заметки
Строки сравниваются по буквенно-цифровым значениям сортировки, начиная с первого знака. Дополнительные сведения о двоичном сравнении, текстовом сравнение и порядке сортировки содержатся в разделе Оператор Option Compare.
.gif "Примечание о безопасности") Примечание о безопасности. |
|---|
Если приложение принимает решение, связанное с безопасностью, на основе результата сравнения или операции изменения регистра, то необходимо использовать метод String.Compare и передать Ordinal или OrdinalIgnoreCase в качестве аргумента comparisonType. Дополнительные сведения см. в разделе Влияние языка и региональных параметров на строки в Visual Basic. |
Пример
В данном примере функция StrComp используется для возврата результатов сравнения строк. Если третий аргумент опущен, то выполняется тип сравнения, определенный в операторе Option Compare или настройках проекта по умолчанию.
' Defines variables.
Dim TestStr1 As String = "ABCD"
Dim TestStr2 As String = "abcd"
Dim TestComp As Integer
' The two strings sort equally. Returns 0.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Text)
' TestStr1 sorts after TestStr2. Returns -1.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Binary)
' TestStr2 sorts before TestStr1. Returns 1.
TestComp = StrComp(TestStr2, TestStr1)
Требования
Пространство имен: Microsoft.VisualBasic
**Модуль:**Strings
**Сборка:**Visual Basic (библиотека времени выполнения, в Microsoft.VisualBasic.dll)