1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-23 23:12:09 +01:00

simdjson : fix XML by converting para to simpara tags via script

This commit is contained in:
Gina Peter Banyard
2026-01-25 15:18:55 +00:00
parent a35a51c6eb
commit 4c6376aca3
9 changed files with 113 additions and 113 deletions

View File

@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3f3362ebcdd1a27cf9c9c751dd5cbe8a6264d1c3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.simdjson" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.simdjson">
<?phpdoc extension-membership="pecl" ?>
<title>Simdjson</title>
<titleabbrev>Simdjson</titleabbrev>
<preface xml:id="intro.simdjson">
&reftitle.intro;
<para>
<simpara>
Proporciona un decodificado JSON más rápido gracias a las ligaduras simdjson para PHP (Single Instruction, Multiple Data)
</para>
</simpara>
</preface>
&reference.simdjson.setup;

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e062629d35eb853ca01b27cb9e4acdad7d4de1b Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.simdjson-decode">
<refnamediv>
@@ -15,11 +15,11 @@
<methodparam choice="opt"><type>bool</type><parameter>associative</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>depth</parameter><initializer>512</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Toma una cadena codificada en JSON y la convierte en un valor PHP.
Esto utiliza una Instrucción Simultánea más Rápida, Datos Múltiples (Simultaneous Instruction, Multiple Data - SIMD)
que <function>json_decode</function> cuando es soportada por la arquitectura del ordenador.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -28,32 +28,32 @@
<varlistentry>
<term><parameter>json</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> <parameter>json</parameter> a decodificar.
</para>
<para>
</simpara>
<simpara>
Esta función solo funciona con cadenas codificadas en UTF-8.
</para>
<para>
</simpara>
<simpara>
Esta función analiza las entradas válidas que
<function>json_decode</function> puede decodificar,
siempre que sean inferiores a 4 Go de longitud.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>associative</parameter></term>
<listitem>
<para>
<simpara>
Cuando &true;, los objetos JSON serán devueltos como
&array; asociativos; cuando sean &false;, los objetos JSON serán devueltos como &object;s.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>depth</parameter></term>
<listitem>
<para>
<simpara>
La profundidad máxima de la estructura a decodificar.
El valor debe ser superior a <literal>0</literal>,
e inferior o igual a <literal>2147483647</literal>.
@@ -61,7 +61,7 @@
Aquellos que llamen a esta función deberían utilizar valores razonablemente pequeños,
ya que profundidades mayores requieren más espacio de búfer y aumentarán
la profundidad de recursión, a diferencia de la implementación actual de <function>json_decode</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -69,24 +69,24 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve el valor codificado en <parameter>json</parameter> en el
tipo PHP apropiado. Los valores <literal>true</literal>, <literal>false</literal> y
<literal>null</literal> son devueltos respectivamente como &true;, &false; y &null;.
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
Si <parameter>json</parameter> es inválido, una <classname>SimdJsonException</classname> es lanzada a partir de PECL simdjson 2.1.0,
mientras que anteriormente, una <classname>RuntimeException</classname> era lanzada.
</para>
<para>
</simpara>
<simpara>
Si <parameter>depth</parameter> está fuera del rango permitido,
una <classname>SimdJsonValueError</classname> es lanzada a partir de PECL simdjson 3.0.0,
mientras que anteriormente, un error de nivel <constant>E_WARNING</constant> era lanzado.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -258,18 +258,18 @@ object(stdClass)#1 (1) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
La especificación JSON no es JavaScript, sino un subconjunto de JavaScript.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
En el caso de que la decodificación falle,
una <classname>SimdJsonException</classname> es lanzada
y <methodname>SimdJsonException::getCode</methodname> y
<methodname>SimdJsonException::getMessage</methodname> pueden ser utilizados
para determinar la naturaleza exacta del error.
</para>
</simpara>
</note>
</refsect1>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e062629d35eb853ca01b27cb9e4acdad7d4de1b Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.simdjson-is-valid">
<refnamediv>
@@ -14,9 +14,9 @@
<methodparam><type>string</type><parameter>json</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>depth</parameter><initializer>512</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Toma un string codificado en JSON y devuelve true si es válido.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -25,23 +25,23 @@
<varlistentry>
<term><parameter>json</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> <parameter>json</parameter> a validar.
</para>
<para>
</simpara>
<simpara>
Esta función solo funciona con strings codificados en UTF-8.
</para>
<para>
</simpara>
<simpara>
Esta función valida las entradas que
<function>json_decode</function> puede decodificar,
siempre que sean inferiores a 4 Go de longitud.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>depth</parameter></term>
<listitem>
<para>
<simpara>
La profundidad máxima de la estructura a decodificar.
El valor debe ser superior a <literal>0</literal>,
e inferior o igual a <literal>2147483647</literal>.
@@ -49,7 +49,7 @@
Quienes llamen a esta función deberían utilizar valores razonablemente pequeños,
ya que profundidades mayores requieren más espacio de búfer y aumentarán
la profundidad de recursión, a diferencia de la implementación actual de <function>json_decode</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -57,23 +57,23 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si <parameter>json</parameter> es un string JSON
válido, de lo contrario &false;.
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
Si <parameter>json</parameter> es inválido, se lanza una <classname>SimdJsonException</classname> a partir de PECL simdjson 2.1.0,
mientras que anteriormente se lanzaba una <classname>RuntimeException</classname>.
</para>
<para>
</simpara>
<simpara>
Si <parameter>depth</parameter> está fuera del rango permitido,
se lanza una <classname>SimdJsonValueError</classname> a partir de PECL simdjson 3.0.0,
mientras que anteriormente se lanzaba un error de nivel <constant>E_WARNING</constant>.
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -143,18 +143,18 @@ bool(false)
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
La especificación JSON no es JavaScript, sino un subconjunto de JavaScript.
</para>
</simpara>
</note>
<note>
<para>
<simpara>
En caso de que la decodificación falle,
se lanza una <classname>SimdJsonException</classname>
y <methodname>SimdJsonException::getCode</methodname> y
<methodname>SimdJsonException::getMessage</methodname> pueden ser utilizados
para determinar la naturaleza exacta del error.
</para>
</simpara>
</note>
</refsect1>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3f3362ebcdd1a27cf9c9c751dd5cbe8a6264d1c3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.simdjson-key-count" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.simdjson-key-count">
<refnamediv>
<refname>simdjson_key_count</refname>
<refpurpose>Devuelve el valor a un puntero JSON.</refpurpose>
@@ -16,9 +16,9 @@
<methodparam choice="opt"><type>int</type><parameter>depth</parameter><initializer>512</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>throw_if_uncountable</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Cuenta el número de elementos del objeto/array encontrado en el puntero JSON solicitado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,23 +27,23 @@
<varlistentry>
<term><parameter>json</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> <parameter>json</parameter> a consultar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> del puntero JSON.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>depth</parameter></term>
<listitem>
<para>
<simpara>
La profundidad máxima de la estructura a decodificar.
El valor debe ser superior a <literal>0</literal>,
e inferior o igual a <literal>2147483647</literal>.
@@ -51,17 +51,17 @@
Aquellos que llamen a esta función deberían utilizar valores razonablemente pequeños,
ya que profundidades mayores requieren más espacio de búfer y aumentarán
la profundidad de recursión, a diferencia de la implementación actual de <function>json_decode</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>throw_if_uncountable</parameter></term>
<listitem>
<para>
<simpara>
Cuando es verdadero, se lanzará una <classname>SimdJsonException</classname>
en lugar de devolver 0 cuando el valor apuntado por el JSON no es ni
un objeto ni un array.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -69,9 +69,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve un &integer; con el número de elementos del valor en el puntero JSON dado.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3f3362ebcdd1a27cf9c9c751dd5cbe8a6264d1c3 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.simdjson-key-exists" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.simdjson-key-exists">
<refnamediv>
<refname>simdjson_key_exists</refname>
<refpurpose>Verifica si el JSON contiene el valor referenciado por un puntero JSON.</refpurpose>
@@ -15,9 +15,9 @@
<methodparam><type>string</type><parameter>key</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>depth</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
Cuenta el número de elementos del objeto/array encontrado en el puntero JSON solicitado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -26,23 +26,23 @@
<varlistentry>
<term><parameter>json</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> <parameter>json</parameter> a consultar.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> del puntero JSON.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>depth</parameter></term>
<listitem>
<para>
<simpara>
La profundidad máxima de la estructura a decodificar.
El valor debe ser superior a <literal>0</literal>,
e inferior o igual a <literal>2147483647</literal>.
@@ -50,17 +50,17 @@
Los que llamen a esta función deberían utilizar valores razonablemente pequeños,
ya que profundidades mayores requieren más espacio de búfer y aumentarán
la profundidad de recursión, a diferencia de la implementación actual de <function>json_decode</function>.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>throw_if_uncountable</parameter></term>
<listitem>
<para>
<simpara>
Cuando es verdadero, se lanzará una <classname>SimdJsonException</classname>
en lugar de devolver 0 cuando el valor apuntado por el JSON no es ni
un objeto ni un array.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -68,10 +68,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve &true; si el puntero JSON es válido y referencia un valor encontrado en una cadena JSON válida.
Devuelve &false; si el JSON es válido pero no contiene el puntero JSON.
</para>
</simpara>
</refsect1>
</refentry>

View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5e062629d35eb853ca01b27cb9e4acdad7d4de1b Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.simdjson-key-value">
<refnamediv>
@@ -16,9 +16,9 @@
<methodparam choice="opt"><type>bool</type><parameter>associative</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>depth</parameter><initializer>512</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Decodifica y devuelve el valor encontrado en el indicador JSON solicitado.
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -27,40 +27,40 @@
<varlistentry>
<term><parameter>json</parameter></term>
<listitem>
<para>
<simpara>
El <parameter>json</parameter> <type>string</type> a interrogar y decodificar.
</para>
<para>
</simpara>
<simpara>
Esta función solo funciona con cadenas codificadas en UTF-8.
</para>
<para>
</simpara>
<simpara>
Esta función analiza las entradas válidas que
<function>json_decode</function> puede decodificar,
siempre que sean inferiores a 4 Go de longitud.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>key</parameter></term>
<listitem>
<para>
<simpara>
El <type>string</type> del puntero JSON.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>associative</parameter></term>
<listitem>
<para>
<simpara>
Cuando &true; los objetos JSON serán devueltos en forma
de &array; asociativos; cuando son &false;, los objetos JSON serán devueltos en forma de &object;s.
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>depth</parameter></term>
<listitem>
<para>
<simpara>
La profundidad máxima de la estructura a decodificar.
El valor debe ser superior a <literal>0</literal>,
e inferior o igual a <literal>2147483647</literal>.
@@ -68,7 +68,7 @@
Quienes llamen a esta función deberían utilizar valores razonablemente pequeños,
ya que profundidades mayores requieren más espacio de búfer y aumentarán
la profundidad de recursión, a diferencia de la implementación actual de <function>json_decode</function>.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -76,24 +76,24 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
Devuelve la parte del valor codificado en <parameter>json</parameter>
que <parameter>key</parameter> referencia en el tipo PHP apropiado.
Los valores <literal>true</literal>, <literal>false</literal> y
<literal>null</literal> son devueltos respectivamente como &true;, &false; y &null;.
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
Si <parameter>json</parameter> es inválido, una <classname>SimdJsonException</classname> es lanzada a partir de PECL simdjson 2.1.0,
mientras que anteriormente, una <classname>RuntimeException</classname> era lanzada.
</para>
<para>
</simpara>
<simpara>
Si <parameter>depth</parameter> está fuera del rango permitido,
una <classname>SimdJsonValueError</classname> es lanzada a partir de PECL simdjson 3.0.0,
mientras que anteriormente, un error de nivel <constant>E_WARNING</constant> era lanzado.
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;

View File

@@ -1,21 +1,21 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 605553e228c78a9368736f4ff36d185cf7e6eb22 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="simdjson.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="simdjson.setup">
&reftitle.setup;
<section xml:id="simdjson.installation">
&reftitle.install;
<para>
<simpara>
&pecl.moved;
</para>
<para>
</simpara>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;simdjson">&url.pecl.package;simdjson</link>.
</para>
<para>
</simpara>
<simpara>
&pecl.windows.download.avail;
</para>
</simpara>
</section>
</chapter>
<!-- Keep this comment at the end of the file

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.simdjsonexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.simdjsonexception" role="class">
<title>La clase SimdJsonException</title>
<titleabbrev>SimdJsonException</titleabbrev>
@@ -10,14 +10,14 @@
<!-- {{{ SimdJsonException intro -->
<section xml:id="simdjsonexception.intro">
&reftitle.intro;
<para>
<simpara>
Excepción lanzada si <function>simdjson_decode</function>,
<function>simdjson_key_count</function>,
<function>simdjson_key_exists</function>,
o <function>simdjson_key_value</function>.
Para obtener los valores posibles, ver las <link linkend="simdjson.constants">constantes de error simdjson</link>.
</para>
</simpara>
</section>
<!-- }}} -->

View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d17b7b4947e7819ff5036715dd706be87ae4def Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 78cc29837ed269491a4fc330797c7184eca7ed2f Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.simdjsonvalueerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.simdjsonvalueerror" role="class">
<title>La clase SimdJsonValueError</title>
<titleabbrev>SimdJsonValueError</titleabbrev>
@@ -10,12 +10,12 @@
<!-- {{{ SimdJsonValueError intro -->
<section xml:id="simdjsonvalueerror.intro">
&reftitle.intro;
<para>
<simpara>
Una excepción <classname>SimdJsonValueError</classname> es lanzada cuando el
tipo de un argumento de una función de simdjson es correcto pero el valor
de éste es incorrecto.
Por ejemplo, cuando la decodificación JSON <varname>$depth</varname> no es positiva o cuando <varname>$depth</varname> es demasiado grande.
</para>
</simpara>
</section>
<!-- }}} -->