Skip to content

Commit 3fdeee9

Browse files
SobakSobak
committed
Sync with EN
1 parent 4dad89e commit 3fdeee9

File tree

18 files changed

+309
-41
lines changed

18 files changed

+309
-41
lines changed

‎language/oop5/constants.xml

Lines changed: 55 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: fc174e8d6162091550edde46159917ee7e5a2e73 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 7ddc30e0d2087d75b8f50da40668f4e422c6a4c5 Maintainer: sobak Status: ready -->
33
<sect1 xml:id="language.oop5.constants" xmlns="http://docbook.org/ns/docbook">
44
<title>Stałe w klasach</title>
55
<para>
@@ -120,6 +120,60 @@ Fatal error: Uncaught Error: Cannot access private const Foo::BAZ in …
120120
Od PHP 7.1.0 dla stałych klasach dozwolone są modyfikatory widoczności.
121121
</para>
122122
</note>
123+
<example>
124+
<title>Sprawdzanie wariancji widoczności stałej klasy, od PHP 8.3.0</title>
125+
<programlisting role="php">
126+
<![CDATA[
127+
<?php
128+
129+
interface MyInterface
130+
{
131+
public const VALUE = 42;
132+
}
133+
134+
class MyClass implements MyInterface
135+
{
136+
protected const VALUE = 42;
137+
}
138+
?>
139+
]]>
140+
</programlisting>
141+
&example.outputs.83;
142+
<screen>
143+
<![CDATA[
144+
Fatal error: Access level to MyClass::VALUE must be public (as in interface MyInterface) …
145+
]]>
146+
</screen>
147+
</example>
148+
<note>
149+
<simpara>
150+
Od PHP 8.3.0 wariancja widoczności jest sprawdzana bardziej rygorystycznie.
151+
Przed tą wersją, widoczność stałej klasy mogła być inna
152+
od widoczności tej stałej w zaimplementowanym interfejsie.
153+
</simpara>
154+
</note>
155+
<example>
156+
<title>Składnia pobierania stałej klasy, od PHP 8.3.0</title>
157+
<programlisting role="php">
158+
<![CDATA[
159+
<?php
160+
class Foo {
161+
public const BAR = 'bar';
162+
private const BAZ = 'baz';
163+
}
164+
165+
$name = 'BAR';
166+
echo Foo::{$name}, PHP_EOL; // bar
167+
?>
168+
]]>
169+
</programlisting>
170+
</example>
171+
<note>
172+
<para>
173+
Od PHP 8.3.0 stałe klas mogą być pobierane dynamicznie przy użyciu
174+
zmiennej.
175+
</para>
176+
</note>
123177
</sect1>
124178
<!-- Keep this comment at the end of the file
125179
Local variables:

‎language/operators/arithmetic.xml

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -65,10 +65,12 @@
6565
</tgroup>
6666
</table>
6767
<simpara>
68-
Operator dzielenia ("/") zwraca liczbę zmiennoprzecinkową, chyba że oba argumenty (operandy)
69-
są liczbami całkowitymi (lub ciągami znaków, które są konwertowane na liczby całkowite) i liczby te
70-
mogą się równo podzielić - w tym wypadku zostanie zwrócona liczba całkowita. Aby
71-
dowiedzieć się więcej o dzieleniu liczb całkowitych zobacz <function>intdiv</function>.
68+
Operator dzielenia <literal>/</literal> zwraca liczbę zmiennoprzecinkową,
69+
chyba że oba argumenty (tzw. operandy) są liczbami całkowitymi <type>int</type> (lub
70+
<link linkend="language.types.numeric-strings">numerycznymi ciągami znaków</link>,
71+
które są konwertowane na liczby całkowite) i licznik jest wielokrotnością
72+
dzielnika, to wtedy zostanie zwrócona liczba całkowita.
73+
Dla dzielenia liczb całkowitych zapoznaj się też z funkcją <function>intdiv</function>.
7274
</simpara>
7375
<simpara>
7476
Argumenty modulo są konwertowane do typu <type>int</type>
@@ -77,21 +79,30 @@
7779
</simpara>
7880
<para>
7981
Wynik dzielenia modulo <literal>%</literal> ma taki sam znak,
80-
jak dzielna. Oznacza to, że wynik <literal>$a % $b</literal>
82+
jak dzielna. Oznacza to, że wynik <code>$a % $b</code>
8183
będzie miał taki sam znak jak <varname>$a</varname>. Przykładowo:
8284
<informalexample>
8385
<programlisting role="php">
8486
<![CDATA[
8587
<?php
8688
87-
echo (5 % 3)."\n"; // wyświetla 2
88-
echo (5 % -3)."\n"; // wyświetla 2
89-
echo (-5 % 3)."\n"; // wyświetla -2
90-
echo (-5 % -3)."\n"; // wyświetla -2
89+
var_dump(5 % 3);
90+
var_dump(5 % -3);
91+
var_dump(-5 % 3);
92+
var_dump(-5 % -3);
9193
9294
?>
9395
]]>
9496
</programlisting>
97+
&example.outputs;
98+
<screen>
99+
<![CDATA[
100+
int(2)
101+
int(2)
102+
int(-2)
103+
int(-2)
104+
]]>
105+
</screen>
95106
</informalexample>
96107
</para>
97108
<sect2 role="seealso">

‎language/predefined/exceptions.xml

Lines changed: 2 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: d269b2528db7c5a228cf0fd3218e7d24d8c71633 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 4bf789e981af0836c41daa16e57ef86c21497faa Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44

55
<part xml:id="reserved.exceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -28,6 +28,7 @@
2828
&language.predefined.valueerror;
2929
&language.predefined.unhandledmatcherror;
3030
&language.predefined.fibererror;
31+
&language.predefined.requestparsebodyexception;
3132
</part>
3233

3334
<!-- Keep this comment at the end of the file

‎reference/array/functions/array-all.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 679cf93fa1e54cde82fc9cf545966eb13bcb0638 Maintainer: sobak Status: ready -->
33
<refentry xml:id="function.array-all" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>array_all</refname>
@@ -9,7 +9,7 @@
99
<refsect1 role="description">
1010
&reftitle.description;
1111
<methodsynopsis>
12-
<type>mixed</type><methodname>array_all</methodname>
12+
<type>bool</type><methodname>array_all</methodname>
1313
<methodparam><type>array</type><parameter>array</parameter></methodparam>
1414
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
1515
</methodsynopsis>

‎reference/array/functions/array-any.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 596c11440dc232b8ed1836d7e3afe2ed5b225a7b Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 679cf93fa1e54cde82fc9cf545966eb13bcb0638 Maintainer: sobak Status: ready -->
33
<refentry xml:id="function.array-any" xmlns="http://docbook.org/ns/docbook">
44
<refnamediv>
55
<refname>array_any</refname>
@@ -9,7 +9,7 @@
99
<refsect1 role="description">
1010
&reftitle.description;
1111
<methodsynopsis>
12-
<type>mixed</type><methodname>array_any</methodname>
12+
<type>bool</type><methodname>array_any</methodname>
1313
<methodparam><type>array</type><parameter>array</parameter></methodparam>
1414
<methodparam><type>callable</type><parameter>callback</parameter></methodparam>
1515
</methodsynopsis>

‎reference/bc/functions/bcdiv.xml

Lines changed: 25 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<!-- CREDITS: sobak -->
55
<refentry xml:id="function.bcdiv" xmlns="http://docbook.org/ns/docbook">
@@ -50,11 +50,25 @@
5050
<refsect1 role="returnvalues">
5151
&reftitle.returnvalues;
5252
<para>
53-
Zwraca wynik dzielenia jako łańcuch znaków lub &null; jeśli
54-
<parameter>num2</parameter> wynosi <literal>0</literal>.
53+
Zwraca wynik dzielenia jako łańcuch znaków.
5554
</para>
5655
</refsect1>
5756

57+
<refsect1 role="errors">
58+
&reftitle.errors;
59+
<para>
60+
Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
61+
<simplelist>
62+
<member><parameter>num1</parameter> lub <parameter>num2</parameter> nie są numerycznymi ciągami znaków poprawnie sformatowanymi dla BCMath</member>
63+
<member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
64+
</simplelist>
65+
</para>
66+
<simpara>
67+
Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>num2</parameter>
68+
wynosi <literal>0</literal>.
69+
</simpara>
70+
</refsect1>
71+
5872
<refsect1 role="changelog">
5973
&reftitle.changelog;
6074
<informaltable>
@@ -72,6 +86,12 @@
7286
Parametr <parameter>scale</parameter> dopuszcza teraz &null;.
7387
</entry>
7488
</row>
89+
<row>
90+
<entry>8.0.0</entry>
91+
<entry>
92+
Dzielenie przez zero powoduje teraz rzucenie <exceptionname>DivisionByZeroError</exceptionname> zamiast zwrócenia null.
93+
</entry>
94+
</row>
7595
</tbody>
7696
</tgroup>
7797
</informaltable>
@@ -97,6 +117,8 @@ echo bcdiv('105', '6.55957', 3); // 16.007
97117
&reftitle.seealso;
98118
<para>
99119
<simplelist>
120+
<member><function>bcdivmod</function></member>
121+
<member><function>bcmod</function></member>
100122
<member><function>bcmul</function></member>
101123
</simplelist>
102124
</para>

‎reference/bc/functions/bcmod.xml

Lines changed: 25 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 87f32875a189be7ee2a8487c0db3958579e4ce72 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<!-- CREDITS: qrak -->
55
<refentry xml:id="function.bcmod" xmlns="http://docbook.org/ns/docbook">
@@ -44,18 +44,33 @@
4444
</para>
4545
</listitem>
4646
</varlistentry>
47+
&bc.scale.description;
4748
</variablelist>
4849
</para>
4950
</refsect1>
5051

5152
<refsect1 role="returnvalues">
5253
&reftitle.returnvalues;
5354
<para>
54-
Zwraca modulo jako łańcuch znaków lub &null; jeśli
55-
<parameter>num2</parameter> wynosi 0.
55+
Zwraca modulo jako łańcuch znaków.
5656
</para>
5757
</refsect1>
5858

59+
<refsect1 role="errors">
60+
&reftitle.errors;
61+
<para>
62+
Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
63+
<simplelist>
64+
<member><parameter>num1</parameter> lub <parameter>num2</parameter> nie są numerycznymi ciągami znaków poprawnie sformatowanymi dla BCMath</member>
65+
<member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
66+
</simplelist>
67+
</para>
68+
<simpara>
69+
Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>num2</parameter>
70+
wynosi <literal>0</literal>.
71+
</simpara>
72+
</refsect1>
73+
5974
<refsect1 role="changelog"><!-- {{{ -->
6075
&reftitle.changelog;
6176
<informaltable>
@@ -73,6 +88,12 @@
7388
Parametr <parameter>scale</parameter> dopuszcza teraz &null;.
7489
</entry>
7590
</row>
91+
<row>
92+
<entry>8.0.0</entry>
93+
<entry>
94+
Dzielenie przez zero powoduje teraz rzucenie <exceptionname>DivisionByZeroError</exceptionname> zamiast zwrócenia null.
95+
</entry>
96+
</row>
7697
<row>
7798
<entry>7.2.0</entry>
7899
<entry>
@@ -127,6 +148,7 @@ echo bcmod('5.7', '1.3'); // 0.5 od PHP 7.2.0; wcześniej 0
127148
<para>
128149
<simplelist>
129150
<member><function>bcdiv</function></member>
151+
<member><function>bcdivmod</function></member>
130152
</simplelist>
131153
</para>
132154
</refsect1>

‎reference/bc/functions/bcpow.xml

Lines changed: 31 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: qrak Status: ready -->
2+
<!-- EN-Revision: e333514f66ae32a3468e05dbe64f55f01ff9451e Maintainer: qrak Status: ready -->
33
<!-- $Revision$ -->
44
<refentry xml:id="function.bcpow" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -37,7 +37,7 @@
3737
<term><parameter>exponent</parameter></term>
3838
<listitem>
3939
<para>
40-
Wykładnik, jako ciąg znaków. Jeśli wykładnik nie jest liczbą całkowitą, jest on przycinany.
40+
Wykładnik, jako ciąg znaków. Musi być wartością bez części ułamkowej.
4141
Dozwolony zakres wykładnika zależy od platformy uruchomieniowej, ale jest to przynajmniej
4242
<literal>-2147483648</literal> do <literal>2147483647</literal>.
4343
</para>
@@ -55,6 +55,22 @@
5555
</para>
5656
</refsect1>
5757

58+
<refsect1 role="errors">
59+
&reftitle.errors;
60+
<para>
61+
Ta funkcja rzuca <exceptionname>ValueError</exceptionname> w następujących wypadkach:
62+
<simplelist>
63+
<member><parameter>num1</parameter> lub <parameter>num2</parameter> nie są numerycznymi ciągami znaków poprawnie sformatowanymi dla BCMath</member>
64+
<member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
65+
<member><parameter>exponent</parameter> ma część ułamkową</member>
66+
</simplelist>
67+
</para>
68+
<simpara>
69+
Ta funkcja rzuca wyjątek <exceptionname>DivisionByZeroError</exceptionname> jeśli <parameter>num2</parameter>
70+
wynosi <literal>0</literal> a <parameter>exponent</parameter> jest ujemny.
71+
</simpara>
72+
</refsect1>
73+
5874
<refsect1 role="changelog"><!-- {{{ -->
5975
&reftitle.changelog;
6076
<informaltable>
@@ -66,6 +82,19 @@
6682
</row>
6783
</thead>
6884
<tbody>
85+
<row>
86+
<entry>8.4.0</entry>
87+
<entry>
88+
Ujemne potęgi 0 wcześniej zwracały, ale teraz rzucają wyjątek <exceptionname>DivisionByZeroError</exceptionname>.
89+
</entry>
90+
</row>
91+
<row>
92+
<entry>8.0.0</entry>
93+
<entry>
94+
Gdy <parameter>exponent</parameter> ma część ułamkową, funkcja rzuca teraz <exceptionname>ValueError</exceptionname>
95+
zamiast przycinać tę wartość.
96+
</entry>
97+
</row>
6998
<row>
7099
<entry>7.3.0</entry>
71100
<entry>

‎reference/bc/functions/bcsqrt.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 23f5599c8cc2713e7a4fdc29d8cceab66c341c48 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: 04c37bc8ca6b2faff2b14b85b4576529444bd6a2 Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<refentry xml:id="function.bcsqrt" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -39,7 +39,7 @@
3939
<refsect1 role="returnvalues">
4040
&reftitle.returnvalues;
4141
<para>
42-
Zwraca pierwiastek kwadratowy jako numeryczny ciąg znaków.
42+
Zwraca pierwiastek kwadratowy jako numeryczny łańcuch znaków poprawnie sformatowany dla BCMath.
4343
</para>
4444
</refsect1>
4545

@@ -48,7 +48,7 @@
4848
<para>
4949
Ta funkcja rzuca <classname>ValueError</classname> w następujących wypadkach:
5050
<simplelist>
51-
<member><parameter>num</parameter> nie jest numerycznym ciągiem znaków zrozumiałym przez BCMath</member>
51+
<member><parameter>num</parameter> nie jest numerycznym ciągiem znaków poprawnie sformatowanym dla BCMath</member>
5252
<member><parameter>num</parameter> wynosi mniej niż <literal>0</literal></member>
5353
<member><parameter>scale</parameter> jest poza dozwolonym zakresem</member>
5454
</simplelist>

‎reference/curl/constants.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 09619263cfbc188c49e9219e0d983bcf90231026 Maintainer: sobak Status: ready -->
2+
<!-- EN-Revision: dec90c90d3662c5433f7c3972f8557321da7b11d Maintainer: sobak Status: ready -->
33
<!-- $Revision$ -->
44
<appendix xml:id="curl.constants" xmlns="http://docbook.org/ns/docbook">
55
&reftitle.constants;
@@ -2028,7 +2028,7 @@
20282028
<listitem>
20292029
<simpara>
20302030
Negotiate auth is supported.
2031-
Dostępna od PHP 7.3.0 i cURL 7.10.6 (deprecated as of 7.38.0)
2031+
Dostępna od PHP 7.3.0 i cURL 7.10.6 (przestarzała od cURL 7.38.0)
20322032
</simpara>
20332033
</listitem>
20342034
</varlistentry>
@@ -2084,7 +2084,7 @@
20842084
</term>
20852085
<listitem>
20862086
<simpara>
2087-
Wspierane są międzynarodowowe nazwy domen.
2087+
Wspierane są międzynarodowe nazwy domen.
20882088
Dostępna od PHP 7.3.0 i cURL 7.12.0
20892089
</simpara>
20902090
</listitem>

0 commit comments

Comments
 (0)