Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion language/predefined/interfaces.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4b06b2d5c3a28a13504972df0f0be6deffabb4c5 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: c67cecc4b6f71010084869cecd7560bc5c8494a7 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->

<part xml:id="reserved.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
Expand Down Expand Up @@ -30,6 +30,7 @@
&language.predefined.stringable;
&language.predefined.unitenum;
&language.predefined.backedenum;
&language.predefined.sortdirection;
&language.predefined.sensitiveparametervalue;
&language.predefined.php-incomplete-class;

Expand Down
106 changes: 106 additions & 0 deletions language/predefined/sortdirection.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,106 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c67cecc4b6f71010084869cecd7560bc5c8494a7 Maintainer: lacatoire Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="enum.sortdirection" role="enum" xmlns="http://docbook.org/ns/docbook">
<title>La enumeración SortDirection</title>
<titleabbrev>SortDirection</titleabbrev>

<partintro>
<section xml:id="enum.sortdirection.intro">
&reftitle.intro;
<simpara>
La enumeración <enumname>SortDirection</enumname> se utiliza para
especificar la dirección en la que se ordenan los valores.
</simpara>
<note>
<simpara>
A partir de PHP 8.6.0, ninguna de las funciones incluidas con PHP acepta un
<enumname>SortDirection</enumname>. Por ejemplo,
<function>array_multisort</function> sigue esperando
<constant>SORT_ASC</constant> o <constant>SORT_DESC</constant>.
</simpara>
</note>
</section>

<section xml:id="enum.sortdirection.synopsis">
&reftitle.enumsynopsis;

<enumsynopsis>
<enumname>SortDirection</enumname>

<enumitem>
<enumidentifier>Ascending</enumidentifier>
</enumitem>

<enumitem>
<enumidentifier>Descending</enumidentifier>
</enumitem>
</enumsynopsis>
</section>

<section xml:id="enum.sortdirection.examples">
&reftitle.examples;
<example>
<title>Ordenar nombres con <enumname>SortDirection</enumname></title>
<programlisting role="php" annotations="non-interactive">
<![CDATA[
<?php

function sortNames(array $names, SortDirection $direction): array
{
match ($direction) {
SortDirection::Ascending => sort($names),
SortDirection::Descending => rsort($names),
};

return $names;
}

$names = ['Charlie', 'Alice', 'Bob'];

print_r(sortNames($names, SortDirection::Descending));
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[0] => Charlie
[1] => Bob
[2] => Alice
)
]]>
</screen>
</example>
</section>

<section xml:id="enum.sortdirection.seealso">
&reftitle.seealso;
<simplelist>
<member><link linkend="array.sorting">Ordenación de arrays</link></member>
<member><link linkend="language.enumerations">Enumeraciones</link></member>
</simplelist>
</section>
</partintro>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
30 changes: 29 additions & 1 deletion language/types/integer.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6b413bea212d1372873771434c2061d2bd64f90a Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 1385c4175bb058d306e2064ea6e6ad84c43c81bc Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no Maintainer: Marqitos -->
<sect1 xml:id="language.types.integer">
<title>Los enteros</title>
Expand Down Expand Up @@ -120,6 +120,34 @@ var_dump($large_number); // float(5.0E+19)
var_dump(PHP_INT_MAX + 1); // sistema de 32 bits: float(2147483648)
// sistema de 64 bits: float(9.2233720368548E+18)
?>
]]>
</programlisting>
</example>

<simpara>
Un literal <type>int</type> negativo es un literal positivo al que se le
aplica el <link linkend="language.operators.arithmetic">operador de negación</link>.
Esto significa que <constant>PHP_INT_MIN</constant> no puede escribirse como
literal: en <literal>-9223372036854775808</literal>, el literal
<literal>9223372036854775808</literal> está fuera de los límites del tipo
<type>int</type> en los sistemas de 64 bits, por lo que se interpreta como un
<type>float</type> antes de ser negado.
Lo mismo se aplica a <literal>-2147483648</literal> en los sistemas de 32 bits.
Utilice en su lugar <constant>PHP_INT_MIN</constant>, o una expresión como
<literal>-9223372036854775807 - 1</literal>.
</simpara>

<example>
<title>El <type>int</type> más pequeño</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(-9223372036854775808); // sistema de 64 bits: float(-9.223372036854776E+18)
var_dump(-9223372036854775807 - 1); // sistema de 64 bits: int(-9223372036854775808)

var_dump(PHP_INT_MIN); // sistema de 32 bits: int(-2147483648)
// sistema de 64 bits: int(-9223372036854775808)
?>
]]>
</programlisting>
</example>
Expand Down
16 changes: 12 additions & 4 deletions reference/hash/functions/hash-file.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 05b26e8d7aa7f3c6830efe4961b2c0e4b28fe450 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 443cb58251a58190e0bf8e337ec469e68e35254a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.hash-file" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -53,9 +53,17 @@
<term><parameter>options</parameter></term>
<listitem>
<para>
Un array de opciones para los diversos algoritmos de hash.
Actualmente, solo el parámetro <parameter>"seed"</parameter> es
soportado para las variantes MurmurHash.
Un array de opciones para los diversos algoritmos de hash:
<variablelist>
<varlistentry>
<term><literal>'seed'</literal> (<type>int</type>)</term>
<listitem><simpara>Soportado por MurmurHash3 y las variantes de XXHash.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><literal>'secret'</literal> (<type>string</type>)</term>
<listitem><simpara>Soportado por <literal>xxh3</literal> y <literal>xxh128</literal>.</simpara></listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
Expand Down
34 changes: 22 additions & 12 deletions reference/hash/functions/hash-init.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fe4ff341037cab316f76ca414f9a1a8ecdc4abfd Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: 443cb58251a58190e0bf8e337ec469e68e35254a Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.hash-init" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -60,9 +60,17 @@
<term><parameter>options</parameter></term>
<listitem>
<para>
Un array de opciones para los algoritmos diversos de hachado.
Actualmente, solo el parámetro <literal>"seed"</literal> es
soportado para las variantes MurmurHash.
Un array de opciones para los algoritmos diversos de hachado:
<variablelist>
<varlistentry>
<term><literal>'seed'</literal> (<type>int</type>)</term>
<listitem><simpara>Soportado por MurmurHash3 y las variantes de XXHash.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><literal>'secret'</literal> (<type>string</type>)</term>
<listitem><simpara>Soportado por <literal>xxh3</literal> y <literal>xxh128</literal>.</simpara></listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
Expand Down Expand Up @@ -121,14 +129,6 @@
<entry>El parámetro <parameter>options</parameter> ha sido añadido.</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>El uso de funciones de hachado no criptográficas (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) con <constant>HASH_HMAC</constant> ha sido desactivado.</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Retorna una <classname>HashContext</classname> en lugar de un recurso.
</entry>
<entry>8.0.0</entry>
<entry>
Levanta una excepción <classname>ValueError</classname> ahora si el
Expand All @@ -139,6 +139,16 @@
<constant>E_WARNING</constant> era emitido.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>El uso de funciones de hachado no criptográficas (adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat) con <constant>HASH_HMAC</constant> ha sido desactivado.</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Retorna una <classname>HashContext</classname> en lugar de un recurso.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
Expand Down
16 changes: 12 additions & 4 deletions reference/hash/functions/hash.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: df2a77acbbb9d381426b863fcfa4d66ac7f5ab6d Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 443cb58251a58190e0bf8e337ec469e68e35254a Maintainer: lacatoire Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.hash" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -52,9 +52,17 @@
<term><parameter>options</parameter></term>
<listitem>
<para>
Un array de opciones para los diversos algoritmos de hachado.
Actualmente, solo el parámetro <parameter>"seed"</parameter> es
soportado para las variantes MurmurHash.
Un array de opciones para los diversos algoritmos de hachado:
<variablelist>
<varlistentry>
<term><literal>'seed'</literal> (<type>int</type>)</term>
<listitem><simpara>Soportado por MurmurHash3 y las variantes de XXHash.</simpara></listitem>
</varlistentry>
<varlistentry>
<term><literal>'secret'</literal> (<type>string</type>)</term>
<listitem><simpara>Soportado por <literal>xxh3</literal> y <literal>xxh128</literal>.</simpara></listitem>
</varlistentry>
</variablelist>
</para>
</listitem>
</varlistentry>
Expand Down
4 changes: 2 additions & 2 deletions reference/intl/dateformatter-constants.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5e36b489fc67bd0b5c424c7d1cd131c2e982bc5c Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: ece319a24140717b5602b45ceb31769d21c4a3e7 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: yes -->
<section xml:id="intl.intldateformatter-constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.constants;
Expand Down Expand Up @@ -137,7 +137,7 @@
<type>int</type>
</term>
<listitem>
<simpara>Calendario no gregoriano</simpara>
<simpara>El calendario por omisión de la configuración local</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="intldateformatter.constants.gregorian">
Expand Down
Loading
Loading