Strings.Filter Metode

Definisi

Ruang nama:

Microsoft.VisualBasic

Rakitan:

Microsoft.VisualBasic.Core.dll

Mengembalikan array berbasis-nol yang berisi subset array String berdasarkan kriteria filter yang ditentukan.

Overload

Filter(Object[], String, Boolean, CompareMethod)	Mengembalikan array berbasis-nol yang berisi subset array String berdasarkan kriteria filter yang ditentukan.
Filter(String[], String, Boolean, CompareMethod)	Mengembalikan array berbasis-nol yang berisi subset array String berdasarkan kriteria filter yang ditentukan.

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

Sumber:

Strings.vb

Mengembalikan array berbasis-nol yang berisi subset array String berdasarkan kriteria filter yang ditentukan.

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

Parameter

Source

Object[]

Wajib diisi. Array string satu dimensi yang akan dicari.

Match

String

Wajib diisi. String untuk dicari.

Include

Boolean

Opsional. Boolean nilai yang menunjukkan apakah akan mengembalikan substring yang menyertakan atau mengecualikan Match. Jika Include adalah True, Filter fungsi mengembalikan subset array yang berisi Match sebagai substring. Jika Include adalah False, Filter fungsi mengembalikan subset array yang tidak berisi Match sebagai substring.

Compare

CompareMethod

Pilihan. Nilai numerik yang menunjukkan jenis perbandingan string yang akan digunakan. Lihat "Pengaturan" untuk nilai.

Mengembalikan

String[]

Array berbasis nol yang berisi subset String array berdasarkan kriteria filter yang ditentukan.

Pengecualian

ArgumentException

Source adalah Nothing atau bukan array satu dimensi.

Contoh

Contoh ini menunjukkan penggunaan Filter fungsi.

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)

Keterangan

Jika tidak ada kecocokan Match yang ditemukan dalam Source, Filter fungsi mengembalikan array kosong. Kesalahan terjadi jika Source diatur ke Nothing atau bukan array satu dimensi.

Array yang Filter dikembalikan oleh fungsi hanya berisi elemen yang cukup untuk memuat jumlah item yang cocok.

Argumen Compare dapat memiliki nilai berikut.

Terus-menerus	Deskripsi
CompareMethod.Binary	Melakukan perbandingan biner
CompareMethod.Text	Melakukan perbandingan tekstual

Lihat juga

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Ringkasan Manipulasi String

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

Sumber:

Strings.vb

Mengembalikan array berbasis-nol yang berisi subset array String berdasarkan kriteria filter yang ditentukan.

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

Parameter

Source

String[]

Wajib diisi. Array string satu dimensi yang akan dicari.

Match

String

Wajib diisi. String untuk dicari.

Include

Boolean

Opsional. Boolean nilai yang menunjukkan apakah akan mengembalikan substring yang menyertakan atau mengecualikan Match. Jika Include adalah True, Filter fungsi mengembalikan subset array yang berisi Match sebagai substring. Jika Include adalah False, Filter fungsi mengembalikan subset array yang tidak berisi Match sebagai substring.

Compare

CompareMethod

Pilihan. Nilai numerik yang menunjukkan jenis perbandingan string yang akan digunakan. Lihat "Pengaturan" untuk nilai.

Mengembalikan

String[]

Array berbasis nol yang berisi subset String array berdasarkan kriteria filter yang ditentukan.

Pengecualian

ArgumentException

Source adalah Nothing atau bukan array satu dimensi.

Contoh

Contoh ini menunjukkan penggunaan Filter fungsi.

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)

Keterangan

Jika tidak ada kecocokan Match yang ditemukan dalam Source, Filter fungsi mengembalikan array kosong. Kesalahan terjadi jika Source diatur ke Nothing atau bukan array satu dimensi.

Array yang Filter dikembalikan oleh fungsi hanya berisi elemen yang cukup untuk memuat jumlah item yang cocok.

Argumen Compare dapat memiliki nilai berikut.

Terus-menerus	Deskripsi
CompareMethod.Binary	Melakukan perbandingan biner
CompareMethod.Text	Melakukan perbandingan tekstual

Lihat juga

• Replace(String, String, String, Int32, Int32, CompareMethod)
• ArgumentException
• Ringkasan Manipulasi String