|
1 | 1 | <?xml version="1.0" encoding="utf-8"?> |
2 | | -<!-- EN-Revision: 5e062629d35eb853ca01b27cb9e4acdad7d4de1b Maintainer: leonardolara Status: ready --> |
| 2 | +<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: leonardolara Status: ready --> |
3 | 3 | <!-- CREDITS: leonardolara --> |
4 | 4 | <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.simdjson-decode"> |
5 | 5 | <refnamediv> |
|
15 | 15 | <methodparam choice="opt"><type>bool</type><parameter>associative</parameter><initializer>&false;</initializer></methodparam> |
16 | 16 | <methodparam choice="opt"><type>int</type><parameter>depth</parameter><initializer>512</initializer></methodparam> |
17 | 17 | </methodsynopsis> |
18 | | - <para> |
| 18 | + <simpara> |
19 | 19 | Recebe uma string codificada em JSON e a converte em um valor PHP. |
20 | 20 | Isso usa uma implementação mais rápida de Instrução Simultânea, Múltiplos Dados |
21 | 21 | do que <function>json_decode</function> quando suportado pela arquitetura do computador. |
22 | | - </para> |
| 22 | + </simpara> |
23 | 23 | </refsect1> |
24 | 24 |
|
25 | 25 | <refsect1 role="parameters"> |
|
28 | 28 | <varlistentry> |
29 | 29 | <term><parameter>json</parameter></term> |
30 | 30 | <listitem> |
31 | | - <para> |
| 31 | + <simpara> |
32 | 32 | A <type>string</type> <parameter>json</parameter> sendo decodificada. |
33 | | - </para> |
34 | | - <para> |
| 33 | + </simpara> |
| 34 | + <simpara> |
35 | 35 | Esta função só funciona com strings codificadas em UTF-8. |
36 | | - </para> |
37 | | - <para> |
| 36 | + </simpara> |
| 37 | + <simpara> |
38 | 38 | Esta função analisa entradas válidas que |
39 | 39 | <function>json_decode</function> pode decodificar, |
40 | 40 | desde que tenham menos de 4 GiB de comprimento. |
41 | | - </para> |
| 41 | + </simpara> |
42 | 42 | </listitem> |
43 | 43 | </varlistentry> |
44 | 44 | <varlistentry> |
45 | 45 | <term><parameter>associative</parameter></term> |
46 | 46 | <listitem> |
47 | | - <para> |
| 47 | + <simpara> |
48 | 48 | Quando &true;, os objetos JSON serão retornados como |
49 | 49 | &array;s associativos; quando &false;, os objetos JSON serão retornados como &object;s. |
50 | | - </para> |
| 50 | + </simpara> |
51 | 51 | </listitem> |
52 | 52 | </varlistentry> |
53 | 53 | <varlistentry> |
54 | 54 | <term><parameter>depth</parameter></term> |
55 | 55 | <listitem> |
56 | | - <para> |
| 56 | + <simpara> |
57 | 57 | Profundidade máxima de aninhamento da estrutura que está sendo decodificada. |
58 | 58 | O valor deve ser maior que <literal>0</literal>, |
59 | 59 | e menor ou igual a <literal>2147483647</literal>. |
60 | 60 |
|
61 | 61 | Os chamadores devem usar valores razoavelmente pequenos, |
62 | 62 | porque profundidades maiores exigem mais espaço de buffer e |
63 | 63 | aumentarão a profundidade de recursão, ao contrário da implementação atual de <function>json_decode</function>. |
64 | | - </para> |
| 64 | + </simpara> |
65 | 65 | </listitem> |
66 | 66 | </varlistentry> |
67 | 67 | </variablelist> |
68 | 68 | </refsect1> |
69 | 69 |
|
70 | 70 | <refsect1 role="returnvalues"> |
71 | 71 | &reftitle.returnvalues; |
72 | | - <para> |
| 72 | + <simpara> |
73 | 73 | Retorna o valor codificado em <parameter>json</parameter> no tipo PHP apropriado. |
74 | 74 | Os valores <literal>true</literal>, <literal>false</literal> e |
75 | 75 | <literal>null</literal> são retornados como &true;, &false; e &null; |
76 | 76 | respectivamente. |
77 | | - </para> |
| 77 | + </simpara> |
78 | 78 | </refsect1> |
79 | 79 |
|
80 | 80 | <refsect1 role="errors"> |
81 | 81 | &reftitle.errors; |
82 | | - <para> |
| 82 | + <simpara> |
83 | 83 | Se <parameter>json</parameter> for inválido, uma <classname>SimdJsonException</classname> será lançada a partir do PECL simdjson 2.1.0, |
84 | 84 | enquanto anteriormente, uma <classname>RuntimeException</classname> era lançada. |
85 | | - </para> |
86 | | - <para> |
| 85 | + </simpara> |
| 86 | + <simpara> |
87 | 87 | Se <parameter>depth</parameter> estiver fora do intervalo permitido, |
88 | 88 | um <classname>SimdJsonValueError</classname> será gerado a partir do PECL simdjson 3.0.0, |
89 | 89 | enquanto anteriormente, um erro de nível <constant>E_WARNING</constant> era gerado. |
90 | | - </para> |
| 90 | + </simpara> |
91 | 91 | </refsect1> |
92 | 92 |
|
93 | 93 | <refsect1 role="examples"> |
@@ -259,18 +259,18 @@ object(stdClass)#1 (1) { |
259 | 259 | <refsect1 role="notes"> |
260 | 260 | &reftitle.notes; |
261 | 261 | <note> |
262 | | - <para> |
| 262 | + <simpara> |
263 | 263 | A especificação JSON não é JavaScript, mas um subconjunto de JavaScript. |
264 | | - </para> |
| 264 | + </simpara> |
265 | 265 | </note> |
266 | 266 | <note> |
267 | | - <para> |
| 267 | + <simpara> |
268 | 268 | Em caso de falha na decodificação, |
269 | 269 | uma <classname>SimdJsonException</classname> é lançada |
270 | 270 | e <methodname>SimdJsonException::getCode</methodname> e |
271 | 271 | <methodname>SimdJsonException::getMessage</methodname> podem ser usados |
272 | 272 | para determinar a natureza exata do erro. |
273 | | - </para> |
| 273 | + </simpara> |
274 | 274 | </note> |
275 | 275 | </refsect1> |
276 | 276 |
|
|
0 commit comments