الفرق بين المراجعتين لصفحة: «PHP/json last error»
< PHP
Kinan-mawed (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>json_last_error()</code> في PHP}}</noinclude>' |
Kinan-mawed (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>json_last_error()</code> في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>json_last_error()</code> في PHP}}</noinclude> | ||
(PHP 5 >= 5.3.0, PHP 7) | |||
تُعيد الدالة <code>json_last_error()</code> آخر خطأ حاصل. | |||
== الوصف == | |||
<syntaxhighlight lang="php"> | |||
int json_last_error ( void ) | |||
</syntaxhighlight>تُعيد آخر خطأ حاصل (إن كان هنالك خطأ) خلال آخر عمليّة ترميز أو فك ترميز لصيغة JSON. | |||
== المعاملات == | |||
لا تملك هذه الدالة أي مُعامِلات. | |||
== القيم المعادة == | |||
تُعيد عدد صحيح. يُمكن للقيمة أن تكون أحد الثوابت التالية: | |||
رموز أخطاء JSON | |||
{| class="wikitable" | |||
|الثابت | |||
|المعنى | |||
|التوافر | |||
|- | |||
|<code>JSON_ERROR_NONE</code> | |||
|لم يحصل أي خطأ. | |||
| | |||
|- | |||
|<code>JSON_ERROR_DEPTH</code> | |||
|تم تجاوز القيمة القصوى للعمق. | |||
| | |||
|- | |||
|<code>JSON_ERROR_STATE_MISMATCH</code> | |||
|صيغة JSON غير صالحة. | |||
| | |||
|- | |||
|<code>JSON_ERROR_CTRL_CHAR</code> | |||
|خطأ محرف التّحكّم، غالبًا ترميز غير صحيح. | |||
| | |||
|- | |||
|<code>JSON_ERROR_SYNTAX</code> | |||
|خطأ في الصّياغة. | |||
| | |||
|- | |||
|<code>JSON_ERROR_UTF8</code> | |||
|أحرف ترميز UTF-8 مُشوّهة، مُرمَّزة غالبًا بشكل غير صحيح. | |||
|PHP 5.3.3 | |||
|- | |||
|<code>JSON_ERROR_RECURSION</code> | |||
|وجود مَرجِع تكراري (recursive reference) أو أكثر في القيمة التي ستُرمَّز. | |||
|PHP 5.5.0 | |||
|- | |||
|<code>JSON_ERROR_INF_OR_NAN</code> | |||
|القيمة التي ستُرمَّز تحوي على INF (لا نهاية) أو القيمة [[PHP/float|NAN]] (وهي قيمةٌ لا تُمثِّل عددًا وهي اختصارٌ للعبارة Not-A-Number). | |||
|PHP 5.5.0 | |||
|- | |||
|<code>JSON_ERROR_UNSUPPORTED_TYPE</code> | |||
|أُدخِلت قيمة من نوع لا يُمكِن ترميزه. | |||
|PHP 5.5.0 | |||
|- | |||
|<code>JSON_ERROR_INVALID_PROPERTY_NAME</code> | |||
|أُدخِل اسم خاصّيّة لا يُمكِن ترميزه. | |||
|PHP 7.0.0 | |||
|- | |||
|<code>JSON_ERROR_UTF16</code> | |||
|أحرف ترميز UTF-16 مُشوّهة، مُرمَّزة غالبًا بشكل غير صحيح. | |||
|PHP 7.0.0 | |||
|} | |||
مراجعة 22:22، 9 أبريل 2018
(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 |