Skip to content

[Sync-En] strings, calendar, gmp: document the ValueErrors thrown by invalid arguments #3755

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacatoire merged 1 commit into from
Oct 26, 2026
Merged

[Sync-En] strings, calendar, gmp: document the ValueErrors thrown by invalid arguments #3755

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
38 changes: 35 additions & 3 deletions reference/calendar/functions/cal-days-in-month.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 87d952ec1b0a2ea00c629378edbbcda43799e6e2 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->

<refentry xml:id="function.cal-days-in-month" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -63,6 +61,40 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide, si <parameter>month</parameter> ou
<parameter>year</parameter> est en dehors de l'intervalle pris en charge, ou si la date n'est pas valide
dans le calendrier donné.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Lève désormais une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide, ou si la date n'est pas valide.
Auparavant, une <constant>E_WARNING</constant> était émise et &false; était retournée.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
36 changes: 33 additions & 3 deletions reference/calendar/functions/cal-from-jd.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 789af834328bf5d492ed174a4fedb226ccaf4b27 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.cal-from-jd" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>cal_from_jd</refname>
Expand Down Expand Up @@ -63,6 +61,38 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Lève désormais une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide.
Auparavant, une <constant>E_WARNING</constant> était émise et &false; était retournée.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
36 changes: 33 additions & 3 deletions reference/calendar/functions/cal-info.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e41aab5ecacf449e51179886c17f1d41735b0234 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->

<refentry xml:id='function.cal-info' xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -79,6 +77,38 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est ni <literal>-1</literal> ni un identifiant de calendrier valide.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Lève désormais une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide.
Auparavant, une <constant>E_WARNING</constant> était émise et &false; était retournée.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
38 changes: 35 additions & 3 deletions reference/calendar/functions/cal-to-jd.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->

<refentry xml:id='function.cal-to-jd' xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -83,6 +81,40 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide, si <parameter>month</parameter> est inférieur à <literal>1</literal>,
ou si <parameter>month</parameter>, <parameter>day</parameter> ou <parameter>year</parameter>
dépasse l'intervalle 32 bits pris en charge. Les autres dates invalides retournent <literal>0</literal>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Lève désormais une <exceptionname>ValueError</exceptionname> si <parameter>calendar</parameter>
n'est pas un identifiant de calendrier valide.
Auparavant, une <constant>E_WARNING</constant> était émise et &false; était retournée.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand Down
36 changes: 33 additions & 3 deletions reference/calendar/functions/jdtojewish.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1ae151672a7ce10bd096505deac85ff198a62ef5 Maintainer: girgias Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.jdtojewish" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>jdtojewish</refname>
Expand Down Expand Up @@ -65,6 +63,38 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>hebrew</parameter> vaut &true;
et que l'année n'est pas comprise entre <literal>1</literal> et <literal>9999</literal>.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Lève désormais une <exceptionname>ValueError</exceptionname> si l'année est hors limites
lorsque <parameter>hebrew</parameter> vaut &true;.
Auparavant, une <constant>E_WARNING</constant> était émise et &false; était retourné.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
12 changes: 9 additions & 3 deletions reference/calendar/functions/jewishtojd.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e80cd5ffceaa6d8bba818b602b7ce20a02df04d9 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->

<refentry xml:id="function.jewishtojd" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -72,6 +70,14 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>year</parameter>
ne tient pas dans un entier 32 bits.
</simpara>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<para>
Expand Down
19 changes: 16 additions & 3 deletions reference/calendar/functions/unixtojd.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 789af834328bf5d492ed174a4fedb226ccaf4b27 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: c35163bad94fdaa1563b45c3c2c957eaa650a504 Maintainer: lacatoire Status: ready -->

<refentry xml:id="function.unixtojd" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -46,6 +44,14 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>timestamp</parameter>
est négatif.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
Expand All @@ -57,6 +63,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Lève désormais une <exceptionname>ValueError</exceptionname> si <parameter>timestamp</parameter>
est négatif. Auparavant, &false; était retourné.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Expand Down
15 changes: 12 additions & 3 deletions reference/gmp/functions/gmp-clrbit.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f38aa0ef2ec36f425ebb18c8978a4e19cf6e5017 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: f2d5808339e7bf94474f0fe0330c3bd9419d4bfe Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.gmp-clrbit" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmp_clrbit</refname>
Expand Down Expand Up @@ -54,6 +52,17 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>index</parameter>
est négatif ou, à partir de PHP 8.5.0, trop grand.
</simpara>
<simpara>
Avant PHP 8.0.0, une <constant>E_WARNING</constant> était émise à la place.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
Expand Down
15 changes: 12 additions & 3 deletions reference/gmp/functions/gmp-fact.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 50d9745e66befe000c677ba9b5f99c0a6e060556 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: f2d5808339e7bf94474f0fe0330c3bd9419d4bfe Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.gmp-fact" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmp_fact</refname>
Expand Down Expand Up @@ -43,6 +41,17 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>num</parameter>
est négatif.
</simpara>
<simpara>
Avant PHP 8.0.0, une <constant>E_WARNING</constant> était émise à la place.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand Down
17 changes: 12 additions & 5 deletions reference/gmp/functions/gmp-pow.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 039ab719e695141ee54409d26ad828337ec31d6e Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: f2d5808339e7bf94474f0fe0330c3bd9419d4bfe Maintainer: lacatoire Status: ready -->
<refentry xml:id="function.gmp-pow" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmp_pow</refname>
Expand Down Expand Up @@ -53,6 +51,17 @@
</para>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
Lève une <exceptionname>ValueError</exceptionname> si <parameter>exponent</parameter>
est négatif.
</simpara>
<simpara>
Avant PHP 8.0.0, une <constant>E_WARNING</constant> était émise à la place.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<para>
Expand All @@ -65,8 +74,6 @@ $pow1 = gmp_pow("2", 31);
echo gmp_strval($pow1) . "\n";
$pow2 = gmp_pow("0", 0);
echo gmp_strval($pow2) . "\n";
$pow3 = gmp_pow("2", -1); // Négatif, génère un warning
echo gmp_strval($pow3) . "\n";
?>
]]>
</programlisting>
Expand Down
Loading
Loading