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

من موسوعة حسوب

(PHP 5 >= 5.3.0, PHP 7)

تُعيد الدالة json_last_error()‎ آخر خطأ حاصل.

الوصف

int json_last_error ( void )

تُعيد آخر خطأ حاصل (إن كان هنالك خطأ) خلال آخر عمليّة ترميز أو فك ترميز لصيغة JSON.

المعاملات

لا تملك هذه الدالة أي مُعامِلات.

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

تُعيد عدد صحيح. يُمكن للقيمة أن تكون أحد الثوابت التالية:

رموز أخطاء JSON

الثابت المعنى التوافر
JSON_ERROR_NONE لم يحصل أي خطأ.
JSON_ERROR_DEPTH تم تجاوز القيمة القصوى للعمق.
JSON_ERROR_STATE_MISMATCH صيغة JSON غير صالحة.
JSON_ERROR_CTRL_CHAR خطأ محرف التّحكّم، غالبًا ترميز غير صحيح.
JSON_ERROR_SYNTAX خطأ في الصّياغة.
JSON_ERROR_UTF8 أحرف ترميز UTF-8 مُشوّهة، مُرمَّزة غالبًا بشكل غير صحيح. PHP 5.3.3
JSON_ERROR_RECURSION وجود مَرجِع تكراري (recursive reference) أو أكثر في القيمة التي ستُرمَّز. PHP 5.5.0
JSON_ERROR_INF_OR_NAN القيمة التي ستُرمَّز تحوي على INF (لا نهاية) أو القيمة NAN (وهي قيمةٌ لا تُمثِّل عددًا وهي اختصارٌ للعبارة Not-A-Number). PHP 5.5.0
JSON_ERROR_UNSUPPORTED_TYPE أُدخِلت قيمة من نوع لا يُمكِن ترميزه. PHP 5.5.0
JSON_ERROR_INVALID_PROPERTY_NAME أُدخِل اسم خاصّيّة لا يُمكِن ترميزه. PHP 7.0.0
JSON_ERROR_UTF16 أحرف ترميز UTF-16 مُشوّهة، مُرمَّزة غالبًا بشكل غير صحيح. PHP 7.0.0