ترجع صفيفا يستند إلى صفر يحتوي على مجموعة فرعية من صفيف سلسلة استنادا إلى معايير تصفية محددة.
بناء الجملة
Filter(sourcearray, match [, include ] [, compare ] )
يحتوي بناء جملة الدالة Filter على الوسيطات التالية:
| الوسيطة | الوصف |
|---|---|
| صفيف المصدر | مطلوبة. صفيف أحادي الأبعاد من السلاسل المطلوب البحث فيها. |
| مطابقة | مطلوبة. سلسلة للبحث عنها. |
| تضمين | اختيارية. تشير قيمة منطقية إلى ما إذا كان سيتم إرجاع سلاسل فرعية تحتوي على تطابق أو استبعاده. إذا كانت قيمة التضمين هي True، فترجع الدالة Filter المجموعة الفرعية للصفيف الذي يحتوي على مطابقة كسلسلة فرعية. إذا كانت قيمة التضمينتساوي False، فترجع الدالة Filter المجموعة الفرعية للصفيف التي لا تحتوي على MATCH كسلسلة فرعية. |
| مقارنة | اختيارية. قيمة رقمية تشير إلى نوع مقارنة السلسلة التي سيتم استخدامها. راجع قسم الإعدادات للقيم. |
إعدادات
يمكن أن تحتوي وسيطة المقارنة على القيم التالية:
| القيمة الثابتة | Value | الوصف |
|---|---|---|
| vbUseCompareOption | –1 | تقوم بإجراء مقارنة باستخدام إعداد جملة مقارنة الخيار . |
| vbBinaryCompare | 0 | ينفذ مقارنة ثنائية. |
| vbTextCompare | 1 | ينفذ مقارنة نصية. |
ملاحظات
إذا لم يتم العثور على تطابقات ضمن sourcearray، ترجع Filter صفيفا فارغا. يحدث خطأ إذا كان sourcearrayفارغا أو لم يكن صفيفا أحادي الأبعاد.
يحتوي الصفيف الذي تم إرجاعه بواسطة الدالة Filter على عناصر كافية لاحتواء عدد العناصر المتطابقة.