החזרת מערך מבוסס אפס המכיל ערכת משנה של מערך מחרוזות בהתבסס על קריטריוני סינון שצוינו.
תחביר
Filter(sourcearray, match [, include ] [, compare ] )
תחביר הפונקציה Filter מכיל את הארגומנטים הבאים:
| ארגומנט | תיאור |
|---|---|
| מועם מקור | נדרש. מערך חד-ממדי של מחרוזות לחיפוש. |
| להתאים | נדרש. מחרוזת לחיפוש. |
| include | אופציונלי. ערך בוליאני המציין אם להחזיר מחרוזת משנה הכוללת או לא לכלול התאמה. אם include הוא True, הפונקציה Filter מחזירה את קבוצת המשנה של המערך המכילה התאמה כ מחרוזת משנה. אם include הוא False, הפונקציה Filter מחזירה את קבוצת המשנה של המערך שאינם מכילים התאמה כ מחרוזת משנה. |
| להשוות | אופציונלי. ערך מספרי המציין את סוג השוואת המחרוזת לשימוש. עיין בסעיף הגדרות לקבלת ערכים. |
הגדרות
הארגומנט compare יכול להכיל את הערכים הבאים:
| קבוע | Value | תיאור |
|---|---|---|
| vbUseCompareOption | –1 | ביצוע השוואה באמצעות ההגדרה של המשפט Option Compare . |
| vbBinaryCompare | 0 | ביצוע השוואה בינארית. |
| vbTextCompare | 1 | ביצוע השוואה טקסטואלית. |
הערות
אם לא נמצאו התאמות התאמה בתוך sourcearray, הפונקציה Filter מחזירה מערך ריק. מתרחשת שגיאה אם sourcearrayהוא Null או אינו מערך חד-ממדי.
המערך המוחזר על-ידי הפונקציה Filter מכיל מספיק רכיבים בלבד כדי להכיל את מספר הפריטים התואמים.