Di Access, fungsi Filter digunakan untuk menampilkan teks atau string dalam sebuah array satu dimensi. Hasil fungsi ini berupa array dengan tipe data Text.
Sintaks penulisan fungsi Filter adalah sebagai berikut:
Keterangan:
Sourcearray (Sumberarray): wajib diisi, berupa array satu dimensi dengan tipe data string.
Match (Kesesuaian): wajib diisi, merupakan teks atau string yang ingin dicari dalam Sourcearray.
Include (Memasukkan): tidak wajib diisi, berisi nilai Boolean yang menunjukkan apakah berisi nilai Match atau tanpa nilai Match. Nilai default True, yang berarti fungsi Filter akan menampilkan nilai dalam Sourcearray yang berisi Match. Bila False, fungsi Filter akan menampilkan nilai dalam Sourcearray yang tidak berisi Match.
Compare (Membandingkan): tidak wajib diisi, berisi nilai Integer yang menunjukkan jenis perbandingan yang digunakan saat mengevaluasi StrComp. Jika Compare bernilai Null, StrComp menampilkan pesan kesalahan. Nilai default Compare adalah Option Compare (-1).
Pengaturan Compare
Bila tidak ada Match dalam Sourcearray, fungsi Filter menghasilkan nilai array kosong.
Fungsi Filter akan menampilkan pesan kesalahan bila nilai Sourcearray Null atau bukan merupakan array satu dimensi.
Ada beberapa cara untuk menampilkan nilai yang dihasilan fungsi Filter. Berikut ini adalah contohnya.
Bila urutan yang diinginkan lebih besar dari pada jumlah urutan yang ada, fungsi Filter akan menampilkan pesan kesalahan "Subscript out of range". Jadi, misalnya:
Sintaks penulisan fungsi Filter adalah sebagai berikut:
Filter (Sourcearray, Match [, Include][, Compare])
Keterangan:
Sourcearray (Sumberarray): wajib diisi, berupa array satu dimensi dengan tipe data string.
Match (Kesesuaian): wajib diisi, merupakan teks atau string yang ingin dicari dalam Sourcearray.
Include (Memasukkan): tidak wajib diisi, berisi nilai Boolean yang menunjukkan apakah berisi nilai Match atau tanpa nilai Match. Nilai default True, yang berarti fungsi Filter akan menampilkan nilai dalam Sourcearray yang berisi Match. Bila False, fungsi Filter akan menampilkan nilai dalam Sourcearray yang tidak berisi Match.
Compare (Membandingkan): tidak wajib diisi, berisi nilai Integer yang menunjukkan jenis perbandingan yang digunakan saat mengevaluasi StrComp. Jika Compare bernilai Null, StrComp menampilkan pesan kesalahan. Nilai default Compare adalah Option Compare (-1).
Pengaturan Compare
Konstanta | Nilai | Keterangan |
vbUseCompareOption | -1 | Melakukan perbandingan dengan menggunakan pengaturan Option Compare (biasanya pernyataan Option Compare berada di awal VBA). |
vbBinaryCompare | 0 | Melakukan perbandingan biner. |
vbTextCompare | 1 | Melakukan perbandingan tekstual. |
vbDatabaseCompare | 2 | Khusus untuk Microsoft Office Access 2007. Melakukan perbandingan berdasarkan informasi yang ada dalam database. |
Bila tidak ada Match dalam Sourcearray, fungsi Filter menghasilkan nilai array kosong.
Fungsi Filter akan menampilkan pesan kesalahan bila nilai Sourcearray Null atau bukan merupakan array satu dimensi.
Ada beberapa cara untuk menampilkan nilai yang dihasilan fungsi Filter. Berikut ini adalah contohnya.
? Filter(Array("Merah", "Kuning", "Hijau"),"i")(0) KuningHuruf "i" pertama (dari urutan 0) ditemukan pada nilai Kuning
? Filter(Array("Merah", "Kuning", "Hijau"),"i")(1) HijauHuruf "i" ke dua (dari urutan 1) ditemukan pada nilai Hijau
? Filter(Array("Merah", "Kuning", "Hijau"),"h")(0) MerahHuruf "h" pertama (dari urutan 0) ditemukan pada nilai Merah
? Filter(Array("Merah", "Kuning", "Hijau"),"h")(1) HijauHuruf "h" ke dua (dari urutan 1) ditemukan pada nilai Hijau
? Filter(Array("Merah", "Kuning", "Hijau"),"h",False)(0) KuningHuruf "h" pertama (dari urutan 0) tidak ada (False) di nilai Kuning
? Filter(Array("Merah", "Kuning", "Hijau"),"m",False)(0) KuningHuruf "m" pertama (dari urutan 0) tidak ada (False) di nilai Kuning
? Filter(Array("Merah", "Kuning", "Hijau"),"m",False)(1) HijauHuruf "m" ke dua (dari urutan 1) tidak ada (False) di nilai Hijau
? Filter(Array("Merah", "Kuning", "Hijau"),"H",true,vbBinaryCompare)(0) HijauHuruf "H" (hanya huruf H besar yang ditunjukkan oleh vbBinaryCompare) pertama (dari urutan 0) ditemukan pada nilai Hijau
? Filter(Array("Merah", "Ungu", "Kuning", "Hijau"),"u",true,vbBinaryCompare)(0) UnguHuruf "u" (hanya huruf u kecil yang ditunjukkan oleh vbBinaryCompare) pertama (dari urutan 0) ditemukan pada nilai Ungu
? Filter(Array("Merah", "Ungu", "Kuning", "Hijau"),"u",true,vbBinaryCompare)(1) KuningHuruf "u" (hanya huruf u kecil yang ditunjukkan oleh vbBinaryCompare) ke dua (dari urutan 1) ditemukan pada nilai Kuning
? Filter(Array("Merah", "Ungu", "Kuning", "Hijau"),"u",true,vbBinaryCompare)(2) HijauHuruf "u" (hanya huruf u kecil yang ditunjukkan oleh vbBinaryCompare) ke tiga (dari urutan 2) ditemukan pada nilai Hijau.
Bila urutan yang diinginkan lebih besar dari pada jumlah urutan yang ada, fungsi Filter akan menampilkan pesan kesalahan "Subscript out of range". Jadi, misalnya:
? Filter(Array("Merah", "Ungu", "Kuning", "Hijau"),"u",true,vbBinaryCompare)(3)Huruf "u" kecil ada 3 nilai, yaitu di nilai Ungu (urutan pertama dengan nilai 0), Kuning (urutan ke dua dengan nilai 1), dan Hijau (urutan ketiga dengan nilai 2). Pada fungsi ini, urutan ke empat (nilai 3) tidak ada. Jadi, bila fungsi di atas akan menampilkan pesan kesalahan "Subscript out of range".
Comments
Post a Comment