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