StrComp 함수(Visual Basic)

아티클
08/20/2008

업데이트: 2007년 11월

문자열 비교의 결과에 따라 -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

예외

예외 형식	오류 번호	조건
ArgumentException	5	Compare 값이 잘못된 경우

비구조적 오류 처리를 사용하는 Visual Basic 6.0 응용 프로그램을 업그레이드하는 경우에는 "오류 번호" 열을 참조하십시오. 오류 번호를 Number 속성(Err 개체)과 비교할 수 있습니다. 그러나 가능하면 이러한 오류 제어 방법을 Visual Basic의 구조적 예외 처리 개요에 설명된 방식으로 바꾸는 것이 좋습니다.

설명

문자열은 첫 문자부터 시작하여 영숫자 정렬 값에 따라 비교됩니다. 이진 비교, 텍스트 비교 및 정렬 순서에 대한 자세한 내용은 Option Compare 문을 참조하십시오.

보안 정보:
응용 프로그램에서 비교 또는 대/소문자 변경 작업의 결과에 따라 보안을 결정하는 경우 작업에 String.Compare 메서드를 사용하고 comparisonType 인수에 대한 Ordinal 또는 OrdinalIgnoreCase를 전달해야 합니다. 자세한 내용은 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)