Skip to content

Commit c28f8c7

Browse files
lacatoirelacatoire
authored
json-last-error.xml: turn the error code table into a variablelist, add the changelog (#1760)
1 parent 68269f0 commit c28f8c7

1 file changed

Lines changed: 93 additions & 69 deletions

File tree

‎reference/json/functions/json-last-error.xml‎

Lines changed: 93 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 058ea1e8420b9c1b24402af52545e8313428e1d1 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 3733e082ad183251e0b63d08b52c448a243f9710 Maintainer: mch Status: ready -->
33
<!-- Reviewed: no -->
44
<refentry xml:id="function.json-last-error" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -27,89 +27,113 @@
2727

2828
<refsect1 role="returnvalues">
2929
&reftitle.returnvalues;
30-
<para>
30+
<simpara>
3131
Функция возвращает целочисленное значение в виде следующих
3232
констант:
33+
</simpara>
34+
<para>
35+
<variablelist>
36+
<varlistentry>
37+
<term><constant>JSON_ERROR_NONE</constant></term>
38+
<listitem>
39+
<simpara>Без ошибок</simpara>
40+
</listitem>
41+
</varlistentry>
42+
<varlistentry>
43+
<term><constant>JSON_ERROR_DEPTH</constant></term>
44+
<listitem>
45+
<simpara>Достигнута максимальная глубина стека</simpara>
46+
</listitem>
47+
</varlistentry>
48+
<varlistentry>
49+
<term><constant>JSON_ERROR_STATE_MISMATCH</constant></term>
50+
<listitem>
51+
<simpara>Недопустимые или сформированные с нарушением формата JSON данные</simpara>
52+
</listitem>
53+
</varlistentry>
54+
<varlistentry>
55+
<term><constant>JSON_ERROR_CTRL_CHAR</constant></term>
56+
<listitem>
57+
<simpara>Ошибка управляющего символа, возможно, неверная кодировка</simpara>
58+
</listitem>
59+
</varlistentry>
60+
<varlistentry>
61+
<term><constant>JSON_ERROR_SYNTAX</constant></term>
62+
<listitem>
63+
<simpara>Синтаксическая ошибка</simpara>
64+
</listitem>
65+
</varlistentry>
66+
<varlistentry>
67+
<term><constant>JSON_ERROR_UTF8</constant></term>
68+
<listitem>
69+
<simpara>Некорректные для кодировки UTF-8 символы, возможно, неверная кодировка</simpara>
70+
</listitem>
71+
</varlistentry>
72+
<varlistentry>
73+
<term><constant>JSON_ERROR_RECURSION</constant></term>
74+
<listitem>
75+
<simpara>Одна или несколько зацикленных ссылок в кодируемом значении</simpara>
76+
</listitem>
77+
</varlistentry>
78+
<varlistentry>
79+
<term><constant>JSON_ERROR_INF_OR_NAN</constant></term>
80+
<listitem>
81+
<simpara>
82+
Одно или несколько значений
83+
<link linkend="language.types.float.nan"><constant>NAN</constant></link>
84+
или <link linkend="function.is-infinite"><constant>INF</constant></link>
85+
в кодируемом значении
86+
</simpara>
87+
</listitem>
88+
</varlistentry>
89+
<varlistentry>
90+
<term><constant>JSON_ERROR_UNSUPPORTED_TYPE</constant></term>
91+
<listitem>
92+
<simpara>Передали значение с неподдерживаемым типом</simpara>
93+
</listitem>
94+
</varlistentry>
95+
<varlistentry>
96+
<term><constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant></term>
97+
<listitem>
98+
<simpara>Название свойства невозможно закодировать</simpara>
99+
</listitem>
100+
</varlistentry>
101+
<varlistentry>
102+
<term><constant>JSON_ERROR_UTF16</constant></term>
103+
<listitem>
104+
<simpara>Некорректный для кодировки UTF-16 символ, возможно, некорректно закодирован</simpara>
105+
</listitem>
106+
</varlistentry>
107+
<varlistentry>
108+
<term><constant>JSON_ERROR_NON_BACKED_ENUM</constant></term>
109+
<listitem>
110+
<simpara>Значение содержит нетипизированное перечисление, которое невозможно сериализовать</simpara>
111+
</listitem>
112+
</varlistentry>
113+
</variablelist>
33114
</para>
34-
<table>
35-
<title>Коды ошибок JSON</title>
115+
</refsect1>
116+
117+
<refsect1 role="changelog">
118+
&reftitle.changelog;
119+
<informaltable>
36120
<tgroup cols="2">
37121
<thead>
38122
<row>
39-
<entry>Константа</entry>
40-
<entry>Значение</entry>
41-
<entry>Доступность</entry>
123+
<entry>&Version;</entry>
124+
<entry>&Description;</entry>
42125
</row>
43126
</thead>
44127
<tbody>
45128
<row>
46-
<entry><constant>JSON_ERROR_NONE</constant></entry>
47-
<entry>Без ошибок</entry>
48-
<entry></entry>
49-
</row>
50-
<row>
51-
<entry><constant>JSON_ERROR_DEPTH</constant></entry>
52-
<entry>Достигнута максимальная глубина стека</entry>
53-
<entry></entry>
54-
</row>
55-
<row>
56-
<entry><constant>JSON_ERROR_STATE_MISMATCH</constant></entry>
57-
<entry>Недопустимые или сформированные с нарушением формата JSON данные</entry>
58-
<entry></entry>
59-
</row>
60-
<row>
61-
<entry><constant>JSON_ERROR_CTRL_CHAR</constant></entry>
62-
<entry>Ошибка управляющего символа, возможно, неверная кодировка</entry>
63-
<entry></entry>
64-
</row>
65-
<row>
66-
<entry><constant>JSON_ERROR_SYNTAX</constant></entry>
67-
<entry>Синтаксическая ошибка</entry>
68-
<entry></entry>
69-
</row>
70-
<row>
71-
<entry><constant>JSON_ERROR_UTF8</constant></entry>
72-
<entry>Некорректные для кодировки UTF-8 символы, возможно, неверная кодировка</entry>
73-
<entry></entry>
74-
</row>
75-
<row>
76-
<entry><constant>JSON_ERROR_RECURSION</constant></entry>
77-
<entry>Одна или несколько зацикленных ссылок в кодируемом значении</entry>
78-
<entry></entry>
79-
</row>
80-
<row>
81-
<entry><constant>JSON_ERROR_INF_OR_NAN</constant></entry>
129+
<entry>8.1.0</entry>
82130
<entry>
83-
Одно или несколько значений
84-
<link linkend="language.types.float.nan"><constant>NAN</constant></link>
85-
или <link linkend="function.is-infinite"><constant>INF</constant></link>
86-
в кодируемом значении
131+
Добавили константу <constant>JSON_ERROR_NON_BACKED_ENUM</constant>.
87132
</entry>
88-
<entry></entry>
89-
</row>
90-
<row>
91-
<entry><constant>JSON_ERROR_UNSUPPORTED_TYPE</constant></entry>
92-
<entry>Передали значение с неподдерживаемым типом</entry>
93-
<entry></entry>
94-
</row>
95-
<row>
96-
<entry><constant>JSON_ERROR_INVALID_PROPERTY_NAME</constant></entry>
97-
<entry>Название свойства невозможно закодировать</entry>
98-
<entry></entry>
99-
</row>
100-
<row>
101-
<entry><constant>JSON_ERROR_UTF16</constant></entry>
102-
<entry>Некорректный для кодировки UTF-16 символ, возможно, некорректно закодирован</entry>
103-
<entry></entry>
104-
</row>
105-
<row>
106-
<entry><constant>JSON_ERROR_NON_BACKED_ENUM</constant></entry>
107-
<entry>Значение содержит нетипизированное перечисление, которое невозможно сериализовать</entry>
108-
<entry>Константа доступна с PHP 8.1.0</entry>
109133
</row>
110134
</tbody>
111135
</tgroup>
112-
</table>
136+
</informaltable>
113137
</refsect1>
114138

115139
<refsect1 role="examples">

0 commit comments

Comments
 (0)