다음을 통해 공유


Filter 함수(Visual Basic)

업데이트: 2007년 11월

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열을 반환합니다.

Function Filter(
   ByVal Source() As { Object | String },
   ByVal Match As String,
   Optional ByVal Include As Boolean = True,
   Optional ByVal Compare As CompareMethod = CompareMethod.Binary
)  As String()

매개 변수

  • Source
    필수적 요소. 찾을 문자열의 1차원 배열입니다.

  • Match
    필수적 요소. 찾을 문자열입니다.

  • Include
    선택적 요소. Match를 포함하거나 제외하는 부분 문자열을 반환할지 여부를 나타내는 Boolean 값입니다. Include가 True이면 Filter 함수는 부분 문자열로 Match가 포함된 배열의 하위 집합을 반환합니다. Include가 False이면 Filter 함수는 부분 문자열로 Match가 포함되지 않은 배열의 하위 집합을 반환합니다.

  • Compare
    선택적 요소. 사용할 문자열 비교의 종류를 나타내는 숫자 값입니다. 값에 대해서는 "설정"을 참조하십시오.

설정

Compare 인수 값은 다음과 같습니다.

상수

설명

CompareMethod.Binary

이진 비교 수행

CompareMethod.Text

텍스트 비교 수행

예외

예외 형식

오류 번호

조건

ArgumentException

9

Source가 Nothing이거나 1차원 배열이 아닙니다.

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

설명

Source에서 Match와 일치하는 내용을 찾지 못하면 Filter 함수는 빈 배열을 반환합니다. Source가 Nothing으로 설정되어 있거나 1차원 배열이 아니면 오류가 발생합니다.

Filter 함수에 의해 반환되는 배열에는 일치 항목의 수를 포함할 수 있을 만큼의 요소만 포함됩니다.

예제

다음 예제에서는 Filter 함수의 사용법을 보여 줍니다.

Dim TestStrings(2) As String
TestStrings(0) = "This"
TestStrings(1) = "Is"
TestStrings(2) = "It"
Dim subStrings() As String
' Returns ["This", "Is"].
subStrings = Filter(TestStrings, "is", True, CompareMethod.Text)
' Returns ["This"].
subStrings = Filter(TestStrings, "is", True, CompareMethod.Binary)
' Returns ["Is", "It"].
subStrings = Filter(TestStrings, "is", False, CompareMethod.Binary)

요구 사항

네임스페이스:Microsoft.VisualBasic

**모듈:**Strings

**어셈블리:**Visual Basic 런타임 라이브러리(Microsoft.VisualBasic.dll)

참고 항목

참조

문자열 조작 요약

Replace 함수(Visual Basic)

ArgumentException