الدالة preg_last_error()‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎ في PHP

(PHP 5 >= 5.3.0, PHP 7)

تُعيد الدالة preg_last_error()‎‎ رمز الخطأ الخاص بتنفيذ آخر تعبير نمطي بصيغة PCRE.

الوصف

int preg_last_error ( void )

تُعيد هذه الدالة رمز الخطأ الخاص بتنفيذ آخر تعبير نمطي بصيغة PCRE.

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

تُعيد الدالة أحد الثوابت التالية ( كما هو موضحٌ في صفحاتها الخاصة):

• PREG_NO_ERROR
• PREG_INTERNAL_ERROR
• PREG_BACKTRACK_LIMIT_ERROR (راجع أيضًا pcre.backtrack_limit)
• PREG_RECURSION_LIMIT_ERROR (راجع أيضًا pcre.recursion_limit)
• PREG_BAD_UTF8_ERROR
• PREG_BAD_UTF8_OFFSET_ERROR (منذ الإصدار PHP 5.3.0)
• PREG_JIT_STACKLIMIT_ERROR (منذ الإصدار PHP 7.0.0)

أمثلة

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

<?php

preg_match('/(?:\D+|<\d+>)*[!?]/', 'foobar foobar foobar');

if (preg_last_error() == PREG_BACKTRACK_LIMIT_ERROR) {
    print 'Backtrack limit was exhausted!';
}

?>

سوف تكون مُخرجات المثال أعلاه كالتالي:

Backtrack limit was exhausted!

مصادر

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