Strings.Filter Metódus

Definíció

Névtér:

Microsoft.VisualBasic

Szerelvény:

Microsoft.VisualBasic.Core.dll

Nulla alapú tömböt ad vissza, amely egy String tömb egy részhalmazát tartalmazza a megadott szűrési feltételek alapján.

Túlterhelések

Name	Description
Filter(Object[], String, Boolean, CompareMethod)	Nulla alapú tömböt ad vissza, amely egy String tömb egy részhalmazát tartalmazza a megadott szűrési feltételek alapján.
Filter(String[], String, Boolean, CompareMethod)	Nulla alapú tömböt ad vissza, amely egy String tömb egy részhalmazát tartalmazza a megadott szűrési feltételek alapján.

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

Forrás:

Strings.vb

Nulla alapú tömböt ad vissza, amely egy String tömb egy részhalmazát tartalmazza a megadott szűrési feltételek alapján.

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()

Paraméterek

Source

Object[]

Kötelező. Keresendő sztringek egydimenziós tömbje.

Match

String

Kötelező. A keresendő sztring.

Include

Boolean

Optional. Boolean érték, amely azt jelzi, hogy vissza szeretné-e adni azokat az alsztringeket, amelyek tartalmazzák vagy kizárják Matchazokat. Ha Include igen True, a Filter függvény a tömb részhalmazát adja vissza, amely részszűrést tartalmaz Match . Ha Include igen False, a függvény annak Filter a tömbnek a részhalmazát adja vissza, amely nem tartalmaz Match alsztringként.

Compare

CompareMethod

Optional. Numerikus érték, amely a használandó sztringek összehasonlításának módját jelzi. Az értékekről lásd a "Beállítások" című témakört.

Válaszok

String[]

Nulla alapú tömb, amely egy String tömb egy adott szűrőfeltételen alapuló részhalmazát tartalmazza.

Kivételek

ArgumentException

Source egydimenziós Nothing tömb.

Példák

Ez a példa a függvény használatát Filter mutatja be.

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)

Megjegyzések

Ha nem található egyezés a Match függvényen belül Source, a Filter függvény üres tömböt ad vissza. Hiba akkor fordul elő, ha Source egydimenziós tömbre Nothing van beállítva vagy nem.

A függvény által Filter visszaadott tömb csak annyi elemet tartalmaz, amennyi a megfeleltethető elemek számát tartalmazza.

Az Compare argumentum a következő értékekkel rendelkezhet.

Állandó	Leírás
CompareMethod.Binary	Bináris összehasonlítást végez
CompareMethod.Text	Szöveges összehasonlítást végez

Lásd még

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Sztringmanipult-kezelés összefoglalása

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

Forrás:

Strings.vb

Nulla alapú tömböt ad vissza, amely egy String tömb egy részhalmazát tartalmazza a megadott szűrési feltételek alapján.

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()

Paraméterek

Source

String[]

Kötelező. Keresendő sztringek egydimenziós tömbje.

Match

String

Kötelező. A keresendő sztring.

Include

Boolean

Optional. Boolean érték, amely azt jelzi, hogy vissza szeretné-e adni azokat az alsztringeket, amelyek tartalmazzák vagy kizárják Matchazokat. Ha Include igen True, a Filter függvény a tömb részhalmazát adja vissza, amely részszűrést tartalmaz Match . Ha Include igen False, a függvény annak Filter a tömbnek a részhalmazát adja vissza, amely nem tartalmaz Match alsztringként.

Compare

CompareMethod

Optional. Numerikus érték, amely a használandó sztringek összehasonlításának módját jelzi. Az értékekről lásd a "Beállítások" című témakört.

Válaszok

String[]

Nulla alapú tömb, amely egy String tömb egy adott szűrőfeltételen alapuló részhalmazát tartalmazza.

Kivételek

ArgumentException

Source egydimenziós Nothing tömb.

Példák

Ez a példa a függvény használatát Filter mutatja be.

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)

Megjegyzések

Ha nem található egyezés a Match függvényen belül Source, a Filter függvény üres tömböt ad vissza. Hiba akkor fordul elő, ha Source egydimenziós tömbre Nothing van beállítva vagy nem.

A függvény által Filter visszaadott tömb csak annyi elemet tartalmaz, amennyi a megfeleltethető elemek számát tartalmazza.

Az Compare argumentum a következő értékekkel rendelkezhet.

Állandó	Leírás
CompareMethod.Binary	Bináris összehasonlítást végez
CompareMethod.Text	Szöveges összehasonlítást végez

Lásd még

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Sztringmanipult-kezelés összefoglalása