החזרת מערך מבוסס אפס המכיל ערכת משנה של מערך מחרוזות בהתבסס על קריטריוני סינון שצוינו.
תחביר
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 מכיל מספיק רכיבים בלבד כדי להכיל את מספר הפריטים התואמים.