ส่งกลับอาร์เรย์แบบฐานศูนย์ที่มีเซตย่อยของอาร์เรย์สตริงตามเกณฑ์การกรองที่ระบุ
ไวยากรณ์
Filter(sourcearray, match [, include ] [, compare ] )
ไวยากรณ์ของฟังก์ชัน Filter มีอาร์กิวเมนต์ดังต่อไปนี้
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| sourcearray | จำเป็น อาร์เรย์หนึ่งมิติของสตริงที่จะค้นหา |
| ตรงกัน | จำเป็น สตริงเพื่อค้นหา |
| รวม | ไม่จำเป็น ค่าบูลีนจะระบุว่าจะส่งกลับสตริงย่อยที่มีหรือยกเว้นการตรงกัน ถ้า include เป็น True แล้ว Filter จะส่งกลับเซตย่อยของอาร์เรย์ที่มี MATCH เป็นสตริงย่อย ถ้า include เป็น False ฟังก์ชัน Filter จะส่งกลับเซตย่อยของอาร์เรย์ที่ไม่มี MATCH เป็น สตริงย่อย |
| เปรียบเทียบ | ไม่จำเป็น ค่าตัวเลขที่ระบุชนิดของการเปรียบเทียบสตริงที่จะใช้ ดูค่าได้ในส่วน การตั้งค่า |
การตั้งค่า
อาร์กิวเมนต์ Compare สามารถมีค่าต่อไปนี้
| ค่าคงที่ | ค่า | คำอธิบาย |
|---|---|---|
| vbUseCompareOption | –1 | ดําเนินการเปรียบเทียบโดยใช้การตั้งค่าของคําสั่ง Option Compare |
| vbBinaryCompare | 0 | ดําเนินการเปรียบเทียบไบนารี |
| vbTextCompare | 1 | ดําเนินการเปรียบเทียบข้อความ |
ข้อสังเกต
หากไม่พบค่า ที่ตรงกัน ภายใน sourcearray ตัวกรอง จะ ส่งกลับอาร์เรย์ว่าง ข้อผิดพลาดจะเกิดขึ้นถ้า sourcearray เป็น Null หรือไม่ใช่อาร์เรย์แบบมิติเดียว
อาร์เรย์ที่ส่งกลับโดยฟังก์ชัน Filter มีองค์ประกอบเพียงพอที่จะมีจํานวนรายการที่ตรงกัน