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