Fungsi Filter

Berlaku Untuk
Access untuk Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Mengembalikan array berbasis nol yang berisi subset dari array string berdasarkan kriteria filter yang ditentukan.

Sintaks

Filter(sourcearray, match [, include ] [, bandingkan ] )

Sintaks fungsi Filter memiliki argumen berikut:

Argumen Deskripsi
sourcearray Diperlukan. Array satu dimensi string untuk dicari.
kecocokan Diperlukan. String untuk dicari.
menyertakan Opsional. Nilai Boolean yang menunjukkan apakah akan mengembalikan substring yang menyertakan atau mengecualikan kecocokan. Jika include adalah True, Filter mengembalikan subset dari array yang berisi match sebagai substring. Jika include adalah False, Filter mengembalikan subset array yang tidak berisi match sebagai substring.
bandingkan Opsional. Nilai numerik yang menunjukkan jenis perbandingan string yang akan digunakan. Lihat bagian Pengaturan untuk nilai-nilai.

Pengaturan

Argumen bandingkan dapat memiliki nilai berikut:

Konstanta Value Deskripsi
vbUseCompareOption –1 Melakukan perbandingan menggunakan pengaturan pernyataan Option Bandingkan .
vbBinaryCompare 0 Melakukan perbandingan biner.
vbTextCompare 1 Melakukan perbandingan tekstual.

Keterangan

Jika tidak ada kecocokan yang ditemukan dalam sourcearray, Filter mengembalikan array kosong. Terjadi kesalahan jika sourcearray adalah Null atau bukan array satu dimensi.

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