Skip to content
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.

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

Update Value Type for Singleton #2010

Merged
merged 1 commit into from
Jan 27, 2025
Merged
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
4 changes: 2 additions & 2 deletions language/types.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 117340b0d72bc8884290450ae8b89643528e0f58 Maintainer: yannick Status: ready -->
<!-- EN-Revision: f908fff129bcd8ec1605658e06457cb04e5b2b51 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<!-- CREDITS: DAnnebicque -->
<chapter xml:id="language.types" xmlns="http://docbook.org/ns/docbook">
Expand Down Expand Up @@ -135,7 +135,7 @@ int(16)
&language.types.void;
&language.types.never;
&language.types.relative-class-types;
&language.types.value;
&language.types.singleton;
&language.types.iterable;
&language.types.declarations;
&language.types.type-juggling;
Expand Down
8 changes: 4 additions & 4 deletions language/types/declarations.xml
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 13273912b0f773c35f05297a47daa7f76dd52669 Maintainer: girgias Status: ready -->
<!-- EN-Revision: f908fff129bcd8ec1605658e06457cb04e5b2b51 Maintainer: girgias Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.types.declarations">
<title>Déclarations de type</title>

<para>
Les déclarations de types peuvent être ajoutées aux arguments des fonctions,
valeurs de retour, à partir de PHP 7.4.0, les propriétés de classe,
et à partir de PHP 8.3.0, les constantes de classe.
Elles assurent que la valeur est du type spécifié au moment de l'appel,
et à partir de PHP 8.3.0, les constantes de classe.
Elles assurent que la valeur est du type spécifié au moment de l'appel,
sinon une <classname>TypeError</classname> est lancée.
</para>

Expand Down Expand Up @@ -281,7 +281,7 @@ Stack trace:
<title>Types d’unions</title>
<warning>
<simpara>
Il n’est pas possible de combiner les deux types de valeur
Il n’est pas possible de combiner les deux types de singleton
<literal>false</literal> et <literal>true</literal> ensemble dans une
union de type.
Utilisez plutôt <type>bool</type>.
Expand Down
49 changes: 49 additions & 0 deletions language/types/singleton.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f908fff129bcd8ec1605658e06457cb04e5b2b51 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<sect1 xml:id="language.types.singleton">
<title>Type singleton</title>

<para>
Les types singleton sont ceux qui n'acceptent qu'une seule valeur.
PHP prend en charge deux types singleton :
<type>false</type> depuis PHP 8.0.0 et <type>true</type>
depuis PHP 8.2.0.
</para>

<warning>
<simpara>
Avant PHP 8.2.0, le type <type>false</type> ne pouvait être utilisé
que dans le cadre d'un
<link linkend="language.types.type-system.composite.union">type union</link>.
</simpara>
</warning>

<note>
<simpara>
Il n'est pas possible de définir des types singleton personnalisés. Considérer
l'utilisation d'une <link linkend="language.types.enumerations">énumération</link> à la place.
</simpara>
</note>

</sect1>
<!-- 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
-->
17 changes: 12 additions & 5 deletions language/types/type-system.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 117340b0d72bc8884290450ae8b89643528e0f58 Maintainer: pierrick Status: ready -->
<!-- EN-Revision: f908fff129bcd8ec1605658e06457cb04e5b2b51 Maintainer: pierrick Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.types.type-system">
<title>Système de type</title>
Expand Down Expand Up @@ -29,9 +29,6 @@
<listitem>
<simpara>Types intégrés</simpara>
<itemizedlist>
<listitem>
<simpara>type <type>null</type></simpara>
</listitem>
<listitem>
<simpara>
Types scalaires :
Expand Down Expand Up @@ -76,7 +73,7 @@
</listitem>
<listitem>
<simpara>
<link linkend="language.types.value">Types de valeur</link>
<link linkend="language.types.singleton">Types singletons</link>
</simpara>
<itemizedlist>
<listitem>
Expand All @@ -87,6 +84,16 @@
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara>
Types unitaires
</simpara>
<itemizedlist>
<listitem>
<simpara><type>null</type></simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara>
Types définis par l'utilisateur (généralement appelés classes-types)
Expand Down
48 changes: 0 additions & 48 deletions language/types/value.xml

This file was deleted.