PHP/preg grep

<noinclude>{{DISPLAYTITLE:الدالة <code>preg_grep()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎</code>‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في PHP}}</noinclude>

(PHP 4, PHP 5, PHP 7)

تُعيد الدالة preg_grep()‎‎ عناصر المصفوفة التي تطابق النمط.

الوصف

array preg_grep ( string $pattern , array $input [, int $flags = 0 ] )

تُعيد هذه الدالة مصفوفة تتكون من عناصر المصفوفة input والتي تتطابق مع النمط pattern المُدخَل.

العوامل

pattern

النمط المراد البحث عنه، كسلسلة نصية.

input

المصفوفة المُدخَلة.

flags

إذا ضبطت على PREG_GREP_INVERT، فستُعيد هذه الدالة عناصر مصفوفة الإدخال التي لا تتطابق مع النمط pattern المُدخل.

القيم المعادة

تُعيد هذه الدالة مصفوفة مفهرسة باستخدام المفاتيح من المصفوفة input.

أمثلة

المثال 1: مثال على الدالة preg_grep()‎‎

<?php
// إعادة كافة عناصر المصفوفة
// التي تحتوي على أرقام عشرية
$fl_array = preg_grep("/^(\d+)?\.\d+$/", $array);
?>

انظر أيضًا

• أنماط PCRE.
• الدالة preg_quote()‎‎: اقتباس حروف التعبير النمطية.
• الدالة preg_match_all()‎‎: إجراء مطابقة شاملة لتعبير نمطي.
• الدالة preg_filter()‎ البحث عن تعبير نمطي واستبداله.
• الدالة preg_last_error()‎‎: إعادة رمز الخطأ الخاص بتنفيذ آخر PCRE regex.

مصادر

• صفحة الدالة preg_grep‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في توثيق PHP الرسمي.