Strings.Filter 메서드

정의

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열을 반환합니다.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

오버로드

Filter(Object[], String, Boolean, CompareMethod)

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열을 반환합니다.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

Filter(String[], String, Boolean, CompareMethod)

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열을 반환합니다.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

Filter(Object[], String, Boolean, CompareMethod)

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열을 반환합니다.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

public static string[]? Filter (object[]? Source, string Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static string[] Filter (object[] Source, string Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member Filter : obj[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]
Public Function Filter (Source As Object(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

매개 변수

Source
Object[]

필수 요소.Required. 찾을 문자열의 1차원 배열입니다.One-dimensional array of strings to be searched.

Match
String

필수 요소.Required. 검색할 문자열입니다.String to search for.

Include
Boolean

선택 사항입니다.Optional. Match를 포함하거나 제외하는 부분 문자열을 반환할지 여부를 나타내는 Boolean 값입니다.Boolean value indicating whether to return substrings that include or exclude Match. IncludeTrue이면 Filter 함수는 부분 문자열로 Match를 포함하는 배열의 하위 집합을 반환합니다.If Include is True, the Filter function returns the subset of the array that contains Match as a substring. IncludeFalse이면 Filter 함수는 부분 문자열로 Match를 포함하지 않는 배열의 하위 집합을 반환합니다.If Include is False, the Filter function returns the subset of the array that does not contain Match as a substring.

Compare
CompareMethod

선택 사항입니다.Optional. 사용할 문자열 비교의 종류를 나타내는 숫자 값입니다.Numeric value indicating the kind of string comparison to use. 값에 대해서는 "설정"을 참조하세요.See "Settings" for values.

반환

String[]

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열입니다.A zero-based array containing a subset of a String array based on specified filter criteria.

예외

SourceNothing이거나 1차원 배열이 아닙니다.Source is Nothing or is not a one-dimensional array.

예제

이 예제에서는 함수를 사용 하는 방법을 보여 줍니다 Filter .This example demonstrates the use of the Filter function.

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)

설명

에와 일치 하는 항목이 없는 경우이 Match Source Filter 함수는 빈 배열을 반환 합니다.If no matches of Match are found within Source, the Filter function returns an empty array. Source가로 설정 Nothing 되었거나 1 차원 배열이 아닌 경우 오류가 발생 합니다.An error occurs if Source is set to Nothing or is not a one-dimensional array.

함수에서 반환 된 배열에는 Filter 일치 하는 항목 수를 포함 하는 충분 한 요소만 포함 됩니다.The array returned by the Filter function contains only enough elements to contain the number of matched items.

인수에는 Compare 다음 값을 사용할 수 있습니다.The Compare argument can have the following values.

상수Constant 설명Description
CompareMethod.Binary 이진 비교를 수행 합니다.Performs a binary comparison
CompareMethod.Text 텍스트 비교를 수행 합니다.Performs a textual comparison

추가 정보

적용 대상

Filter(String[], String, Boolean, CompareMethod)

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열을 반환합니다.Returns a zero-based array containing a subset of a String array based on specified filter criteria.

public static string[]? Filter (string[]? Source, string Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
public static string[] Filter (string[] Source, string Match, bool Include = true, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);
static member Filter : string[] * string * bool * Microsoft.VisualBasic.CompareMethod -> string[]
Public Function Filter (Source As String(), Match As String, Optional Include As Boolean = true, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As String()

매개 변수

Source
String[]

필수 요소.Required. 찾을 문자열의 1차원 배열입니다.One-dimensional array of strings to be searched.

Match
String

필수 요소.Required. 검색할 문자열입니다.String to search for.

Include
Boolean

선택 사항입니다.Optional. Match를 포함하거나 제외하는 부분 문자열을 반환할지 여부를 나타내는 Boolean 값입니다.Boolean value indicating whether to return substrings that include or exclude Match. IncludeTrue이면 Filter 함수는 부분 문자열로 Match를 포함하는 배열의 하위 집합을 반환합니다.If Include is True, the Filter function returns the subset of the array that contains Match as a substring. IncludeFalse이면 Filter 함수는 부분 문자열로 Match를 포함하지 않는 배열의 하위 집합을 반환합니다.If Include is False, the Filter function returns the subset of the array that does not contain Match as a substring.

Compare
CompareMethod

선택 사항입니다.Optional. 사용할 문자열 비교의 종류를 나타내는 숫자 값입니다.Numeric value indicating the kind of string comparison to use. 값에 대해서는 "설정"을 참조하세요.See "Settings" for values.

반환

String[]

지정된 필터링 기준에 따라 String 배열의 하위 집합을 포함하는 0부터 시작하는 배열입니다.A zero-based array containing a subset of a String array based on specified filter criteria.

예외

SourceNothing이거나 1차원 배열이 아닙니다.Source is Nothing or is not a one-dimensional array.

예제

이 예제에서는 함수를 사용 하는 방법을 보여 줍니다 Filter .This example demonstrates the use of the Filter function.

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)

설명

에와 일치 하는 항목이 없는 경우이 Match Source Filter 함수는 빈 배열을 반환 합니다.If no matches of Match are found within Source, the Filter function returns an empty array. Source가로 설정 Nothing 되었거나 1 차원 배열이 아닌 경우 오류가 발생 합니다.An error occurs if Source is set to Nothing or is not a one-dimensional array.

함수에서 반환 된 배열에는 Filter 일치 하는 항목 수를 포함 하는 충분 한 요소만 포함 됩니다.The array returned by the Filter function contains only enough elements to contain the number of matched items.

인수에는 Compare 다음 값을 사용할 수 있습니다.The Compare argument can have the following values.

상수Constant 설명Description
CompareMethod.Binary 이진 비교를 수행 합니다.Performs a binary comparison
CompareMethod.Text 텍스트 비교를 수행 합니다.Performs a textual comparison

추가 정보

적용 대상