Skip to content

Commit 205d499

Browse files
Fan2ShrekFan2Shrek
authored
Sync types with EN (#2128)
1 parent a69b176 commit 205d499

11 files changed

Lines changed: 247 additions & 179 deletions

File tree

‎language/types/array.xml‎

Lines changed: 120 additions & 77 deletions
Large diffs are not rendered by default.

‎language/types/boolean.xml‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 161dde4fe721309398dd324edbf02aec409f127b Maintainer: yannick Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: yannick Status: ready -->
43
<!-- Reviewed: yes Maintainer: mikaelkael -->
54

65
<sect1 xml:id="language.types.boolean">
@@ -132,7 +131,8 @@ if ($show_separators) {
132131
</simpara>
133132
</warning>
134133

135-
<informalexample>
134+
<example>
135+
<title>Conversion en booléen</title>
136136
<programlisting role="php">
137137
<![CDATA[
138138
<?php
@@ -148,7 +148,7 @@ var_dump((bool) "false"); // bool(true)
148148
?>
149149
]]>
150150
</programlisting>
151-
</informalexample>
151+
</example>
152152

153153
</sect2>
154154
</sect1>

‎language/types/callable.xml‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: c897161ca5a62a887295c695adc161b8fde5d772 Maintainer: yannick Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: yannick Status: ready -->
33
<!-- Reviewed: yes Maintainer: girgias -->
44
<!-- CREDITS: DavidA -->
55

@@ -76,13 +76,13 @@
7676
7777
// Un exemple de fonction de rappel
7878
function my_callback_function() {
79-
echo 'hello world!';
79+
echo 'hello world!', PHP_EOL;
8080
}
8181
8282
// Un exemple de méthode de rappel
8383
class MyClass {
8484
static function myCallbackMethod() {
85-
echo 'Hello World!';
85+
echo 'Hello World!', PHP_EOL;
8686
}
8787
}
8888
@@ -102,21 +102,21 @@ call_user_func('MyClass::myCallbackMethod');
102102
// Type 5 : Appel à une méthode statique de classe relative
103103
class A {
104104
public static function who() {
105-
echo "A\n";
105+
echo "A", PHP_EOL;
106106
}
107107
}
108108
109109
class B extends A {
110110
public static function who() {
111-
echo "B\n";
111+
echo "B", PHP_EOL;
112112
}
113113
}
114114
115115
call_user_func(array('B', 'parent::who')); // A, obsoléte à partir de PHP 8.2.0
116116
// Type 6 : Les objets implémentant __invoke peuvent être utilisés comme callables
117117
class C {
118118
public function __invoke($name) {
119-
echo 'Hello ', $name, "\n";
119+
echo 'Hello ', $name, PHP_EOL;
120120
}
121121
}
122122

‎language/types/declarations.xml‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 68976f0e68dbd2c49eaf5d477b6075864a946593 Maintainer: girgias Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: girgias Status: ready -->
33
<!-- Reviewed: no -->
44
<sect1 xml:id="language.types.declarations">
55
<title>Déclarations de type</title>
@@ -321,6 +321,7 @@ Stack trace:
321321
Ceci n’est pas recommandé, car si la valeur par défaut est modifiée dans
322322
une classe enfant, une violation de compatibilité de type sera déclenchée
323323
car le type <type>null</type> devra être ajouté à la déclaration de type.
324+
Ce comportement est également déprécié à partir de PHP 8.4.
324325
</para>
325326
<example>
326327
<title>Ancienne façon de rendre les arguments nullables</title>
@@ -616,7 +617,7 @@ NULL
616617

617618
<example>
618619
<title>Déclaration de type de retour nullable</title>
619-
<programlisting role="php">
620+
<programlisting role="php" annotations="non-interactive">
620621
<![CDATA[
621622
<?php
622623
function get_item(): ?string {
@@ -633,7 +634,7 @@ function get_item(): ?string {
633634

634635
<example>
635636
<title>Déclaration de type pour les propriétés de classe</title>
636-
<programlisting role="php">
637+
<programlisting role="php" annotations="non-interactive">
637638
<![CDATA[
638639
<?php
639640
class User {
@@ -704,7 +705,7 @@ class User {
704705

705706
<example>
706707
<title>Typage strict pour les valeurs d'arguments</title>
707-
<programlisting role="php">
708+
<programlisting role="php" annotations="non-interactive">
708709
<![CDATA[
709710
<?php
710711
declare(strict_types=1);
@@ -759,7 +760,7 @@ int(3)
759760

760761
<example>
761762
<title>Typage strict pour les valeurs de retour</title>
762-
<programlisting role="php">
763+
<programlisting role="php" annotations="non-interactive">
763764
<![CDATA[
764765
<?php
765766
declare(strict_types=1);

‎language/types/float.xml‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: a1e3d629b4f01ee41bd38391cd5c6ae5ee894cb3 Maintainer: yannick Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: yannick Status: ready -->
33
<!-- Reviewed: yes Maintainer: girgias -->
44
<!-- CREDITS: DavidA -->
55

@@ -135,26 +135,28 @@ EXPONENT_DNUM (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
135135
comme étant l'epsilon de la machine, ou le <literal>unit roundoff</literal>,
136136
et est la différence la plus petite acceptable dans les calculs.
137137
</para>
138+
139+
<simpara>
140+
<varname>$a</varname> et <varname>$b</varname> sont égaux sur 5 nombres
141+
après la virgule.
142+
</simpara>
138143

139-
<informalexample>
140-
<simpara>
141-
<varname>$a</varname> et <varname>$b</varname> sont égaux sur 5 nombres
142-
après la virgule.
143-
</simpara>
144+
<example>
145+
<title>Comparaison de nombres flottants</title>
144146
<programlisting role="php">
145147
<![CDATA[
146148
<?php
147149
$a = 1.23456789;
148150
$b = 1.23456780;
149151
$epsilon = 0.00001;
150152
151-
if(abs($a-$b) < $epsilon) {
153+
if( abs($a - $b) < $epsilon) {
152154
echo "true";
153155
}
154156
?>
155157
]]>
156158
</programlisting>
157-
</informalexample>
159+
</example>
158160
</sect2>
159161

160162
<sect2 xml:id="language.types.float.nan">

‎language/types/integer.xml‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: yannick Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: yannick Status: ready -->
33
<!-- Reviewed: yes Maintainer: girgias -->
44
<!-- CREDITS: DavidA -->
55

@@ -47,7 +47,7 @@
4747

4848
<example>
4949
<title>Les entiers littéraux</title>
50-
<programlisting role="php">
50+
<programlisting role="php" annotations="non-interactive">
5151
<![CDATA[
5252
<?php
5353
$a = 1234; // un nombre décimal
@@ -138,7 +138,8 @@ var_dump(PHP_INT_MAX + 1); // 32-bit system: float(2147483648)
138138
plus fin sur la façon dont l'arrondi est exécuté.
139139
</para>
140140

141-
<informalexample>
141+
<example>
142+
<title>Division</title>
142143
<programlisting role="php">
143144
<![CDATA[
144145
<?php
@@ -148,7 +149,7 @@ var_dump(round(25/7)); // float(4)
148149
?>
149150
]]>
150151
</programlisting>
151-
</informalexample>
152+
</example>
152153
</sect2>
153154

154155
<sect2 xml:id="language.types.integer.casting">
@@ -195,7 +196,9 @@ var_dump(round(25/7)); // float(4)
195196
À partir de PHP 8.1.0, une notification de dépréciation est émise lors de la
196197
conversion implicite d'un &float; non-intégral en &integer; perdant en précision.
197198
</simpara>
198-
<programlisting role="php">
199+
<example>
200+
<title>Conversion depuis des nombres flottants</title>
201+
<programlisting role="php">
199202
<![CDATA[
200203
<?php
201204
@@ -211,7 +214,8 @@ var_dump((int) 8.1); // 8 dans les deux cas
211214
var_dump(intval(8.1)); // 8 dans les deux cas
212215
?>
213216
]]>
214-
</programlisting>
217+
</programlisting>
218+
</example>
215219
<para>
216220
Si le nombre à virgule flottante est au delà des limites des &integer;s (habituellement,
217221
<literal>+/- 2.15e+9 = 2^31</literal> sur les plate-formes 32-bit et

‎language/types/iterable.xml‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 161dde4fe721309398dd324edbf02aec409f127b Maintainer: jbnahan Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: jbnahan Status: ready -->
33
<!-- Reviewed: yes Maintainer: girgias -->
44
<sect1 xml:id="language.types.iterable">
55
<title>Itérables</title>
@@ -34,6 +34,9 @@ function gen(): iterable {
3434
yield 3;
3535
}
3636
37+
foreach(gen() as $value) {
38+
echo $value, "\n";
39+
}
3740
?>
3841
]]>
3942
</programlisting>

‎language/types/numeric-strings.xml‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,9 @@ NUM_STRING ({INT_NUM_STRING} | {FLOAT_NUM_STRING})
3737
Toute chaîne contenant la lettre <literal>E</literal> (insensible à la casse)
3838
délimitée par des nombres sera considérée comme un nombre exprimé en notation scientifique.
3939
Cela peut produire des résultats inattendus.
40+
</para>
41+
<example>
42+
<title>Comparaisons avec notation scientifique</title>
4043
<programlisting role="php">
4144
<![CDATA[
4245
<?php
@@ -46,7 +49,7 @@ var_dump("2E1" == "020"); // true, "2E1" is 2 * (10 ^ 1), or 20
4649
?>
4750
]]>
4851
</programlisting>
49-
</para>
52+
</example>
5053
</note>
5154

5255
<sect2 xml:id="language.types.numeric-string.conversion">

‎language/types/object.xml‎

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 4c4b82965384d55f5c3efb1ffa80615acd98a737 Maintainer: yannick Status: ready -->
2+
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: yannick Status: ready -->
43
<!-- Reviewed: yes -->
54

65
<sect1 xml:id="language.types.object">
@@ -14,7 +13,8 @@
1413
afin d'instancier une classe :
1514
</para>
1615

17-
<informalexample>
16+
<example>
17+
<title>Construction d'objet</title>
1818
<programlisting role="php">
1919
<![CDATA[
2020
<?php
@@ -31,7 +31,7 @@ $bar->do_foo();
3131
?>
3232
]]>
3333
</programlisting>
34-
</informalexample>
34+
</example>
3535

3636
<simpara>
3737
Pour une discussion complète, voir le chapitre sur
@@ -53,24 +53,28 @@ $bar->do_foo();
5353
moins d'être itérées.
5454
</para>
5555

56-
<informalexample>
56+
<example>
57+
<title>Conversion en un objet</title>
5758
<programlisting role="php">
5859
<![CDATA[
5960
<?php
6061
$obj = (object) array('1' => 'foo');
61-
var_dump(isset($obj->{'1'})); // affiche 'bool(true)' depuis PHP 7.2.0; 'bool(false)' auparavant
62-
var_dump(key($obj)); // affiche 'string(1) "1"' depuis PHP 7.2.0; 'int(1)' auparavant
62+
var_dump(isset($obj->{'1'})); // affiche 'bool(true)'
63+
64+
// Déprécié depuis PHP 8.1
65+
var_dump(key($obj)); // affiche 'string(1) "1"'
6366
?>
6467
]]>
6568
</programlisting>
66-
</informalexample>
69+
</example>
6770

6871
<para>
6972
Pour n'importe quel autre type, un membre appelé <literal>scalar</literal>
7073
contiendra la valeur.
7174
</para>
7275

73-
<informalexample>
76+
<example>
77+
<title>Conversion <literal>(object)</literal></title>
7478
<programlisting role="php">
7579
<![CDATA[
7680
<?php
@@ -79,7 +83,7 @@ echo $obj->scalar; // Affiche : 'ciao'
7983
?>
8084
]]>
8185
</programlisting>
82-
</informalexample>
86+
</example>
8387

8488
</sect2>
8589
</sect1>

0 commit comments

Comments
 (0)