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

من موسوعة حسوب
< 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!

مصادر