com doc/ru: Обновлен ие до англи йской верси и: reference/array/functions/array-push.xml refere
nce/strings/functions/explode.xml reference/strings/functio ns/number-format.xml reference/strings/functions/parse-str .xml
| From: | Sergey Panteleev | Date: | Mon, 25 Jan 2021 13:38:29 +0000 |
| Subject: | com doc/ru: Обновлен ие до англи йской верси и: reference/array/functions/array-push.xml refere nce/strings/functions/explode.xml reference/strings/functio ns/number-format.xml reference/strings/functions/parse-str .xml |
||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-8773@lists.php.net to get a copy of this message | ||
Commit: e82c94c0ef86daeb4d3370316c8953be6cd759d4
Author: Sergey Panteleev <sergey@php.net> Mon, 25 Jan 2021 16:38:29 +0300
Parents: 4dadf0c0d47df83c117cee2ba8f6ffcde6cba44c
Branches: master
Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=e82c94c0ef86daeb4d3370316c8953be6cd759d4
Log:
Обновление до английской версии
Changed paths:
M reference/array/functions/array-push.xml
M reference/strings/functions/explode.xml
M reference/strings/functions/number-format.xml
M reference/strings/functions/parse-str.xml
diff --git a/reference/array/functions/array-push.xml b/reference/array/functions/array-push.xml index f53707445..5de39f891 100644 --- a/reference/array/functions/array-push.xml +++ b/reference/array/functions/array-push.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: shein Status: ready --> +<!-- EN-Revision: 627fb8f8675566dfd9c3977e3ad2d9fc7b3b3876 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.array-push" xmlns="http://docbook.org/ns/docbook"> @@ -40,7 +40,7 @@ $array[] = $var; <simpara> <function>array_push</function> вызовет предупреждение, если первый аргумент не является массивом. Это отличается от поведения - конструкции <literal>$var[]</literal>, в случае которой будет создан новый + конструкции <literal>$var[]</literal> до PHP 7.1.0, в случае которой будет создан новый массив. </simpara> </note> diff --git a/reference/strings/functions/explode.xml b/reference/strings/functions/explode.xml index 55d1940df..d8f4e74b2 100644 --- a/reference/strings/functions/explode.xml +++ b/reference/strings/functions/explode.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: shein Status: ready --> +<!-- EN-Revision: 923fbe06539286e2a9261ea9982e788b4157ad48 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.explode" xmlns="http://docbook.org/ns/docbook"> @@ -66,9 +66,8 @@ </para> <note> <para> - По историческим причинам, функции <function>implode</function> можно - передавать аргументы в любом порядке, но для <function>explode</function> - это недопустимо. Убедитесь в том, что <parameter>separator</parameter> + До PHP 8.0 функция <function>implode</function> принимала параметры в любом порядке. + Функция <function>explode</function> никогда этого не поддерживала: убедитесь в том, что <parameter>separator</parameter> указан перед аргументом <parameter>string</parameter>. </para> </note> diff --git a/reference/strings/functions/number-format.xml b/reference/strings/functions/number-format.xml index 5ba74cf19..c0f0bad06 100644 --- a/reference/strings/functions/number-format.xml +++ b/reference/strings/functions/number-format.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: irker Status: ready --> +<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: irker Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.number-format" xmlns:xlink="http://www.w3.org/1999/xlink"> +<refentry xml:id="function.number-format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>number_format</refname> <refpurpose>Форматирует число с разделением групп</refpurpose> @@ -12,35 +12,13 @@ &reftitle.description; <methodsynopsis> <type>string</type><methodname>number_format</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam><type>float</type><parameter>num</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>decimals</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>decimal_separator</parameter><initializer>"."</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>thousands_separator</parameter><initializer>","</initializer></methodparam> </methodsynopsis> - <methodsynopsis> - <type>string</type><methodname>number_format</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - <methodparam><type>int</type><parameter>decimals</parameter><initializer>0</initializer></methodparam> - <methodparam><type>string</type><parameter>dec_point</parameter><initializer>"."</initializer></methodparam> - <methodparam><type>string</type><parameter>thousands_sep</parameter><initializer>","</initializer></methodparam> - </methodsynopsis> - <para> - Функция принимает один, два или четыре аргумента (не три): - </para> - <para> - Если передан только один аргумент, <parameter>number</parameter> - будет отформатирован без дробной части, но с запятой (",") между - каждыми тремя цифрами. - </para> <para> - Если переданы два аргумента, <parameter>number</parameter> будет - отформатирован с <parameter>decimals</parameter> знаками после точки - (".") и с запятой (",") между каждыми тремя цифрами. - </para> - <para> - Если переданы все четыре аргумента, <parameter>number</parameter> - будет отформатирован с <parameter>decimals</parameter> знаками после - точки и с разделителем между каждыми тремя цифрами, при этом в качестве - десятичной точки будет использован <parameter>dec_point</parameter>, - а в качестве разделителя групп - <parameter>thousands_sep</parameter>. + Форматирует число сгруппированными тысячами и, возможно, десятичными цифрами. </para> </refsect1> @@ -49,7 +27,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>number</parameter></term> + <term><parameter>num</parameter></term> <listitem> <para> Форматируемое число. @@ -61,11 +39,13 @@ <listitem> <para> Устанавливает число знаков после запятой. + Если <literal>0</literal>, <parameter>decimal_separator</parameter> + опускается в возвращаемом значении. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>dec_point</parameter></term> + <term><parameter>decimal_separator</parameter></term> <listitem> <para> Устанавливает разделитель дробной части. @@ -73,7 +53,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>thousands_sep</parameter></term> + <term><parameter>thousands_separator</parameter></term> <listitem> <para> Устанавливает разделитель тысяч. @@ -87,7 +67,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Отформатированное число <parameter>number</parameter>. + Отформатированное число <parameter>num</parameter>. </para> </refsect1> @@ -105,11 +85,18 @@ </thead> <tbody> <row> + <entry>8.0.0</entry> + <entry> + До этой версии функция <function>number_format</function> принимала один, + два или четыре параметра (но не три). + </entry> + </row> + <row> <entry>7.2.0</entry> <entry> <function>number_format</function> была изменена, чтобы не возвращать <literal>-0</literal>, ранее <literal>-0</literal> могло быть возвращено в - случаях, когда <parameter>number</parameter> был <literal>-0.01</literal>. + случаях, когда <parameter>num</parameter> был <literal>-0.01</literal>. </entry> </row> </tbody> diff --git a/reference/strings/functions/parse-str.xml b/reference/strings/functions/parse-str.xml index f0cf067b7..cae233f5e 100644 --- a/reference/strings/functions/parse-str.xml +++ b/reference/strings/functions/parse-str.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: shein Status: ready --> +<!-- EN-Revision: 4a7ddddc27271967b616ad3400cfbe2a9b48212b Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.parse-str" xmlns="http://docbook.org/ns/docbook"> @@ -49,15 +49,6 @@ крайне <emphasis>НЕ РЕКОМЕНДУЕТСЯ</emphasis>. Подобное использование объявлено <emphasis>УСТАРЕВШИМ</emphasis> с PHP 7.2. </para> - <para> - Динамическое задание переменных в области функции ведёт ровно к тем же - проблемам, что и <link linkend="ini.register-globals">register_globals</link>. - </para> - <para> - Читайте секцию про безопасность раздела - <link linkend="security.globals">Использование Register Globals</link>, в которой - описывается опасность их использования. - </para> </warning> </listitem> </varlistentry>
diff --git a/reference/array/functions/array-push.xml b/reference/array/functions/array-push.xml index f53707445..5de39f891 100644 --- a/reference/array/functions/array-push.xml +++ b/reference/array/functions/array-push.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 9e0f03ac354d797d1d16c0fcc1663e5e170f2727 Maintainer: shein Status: ready --> +<!-- EN-Revision: 627fb8f8675566dfd9c3977e3ad2d9fc7b3b3876 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.array-push" xmlns="http://docbook.org/ns/docbook"> @@ -40,7 +40,7 @@ $array[] = $var; <simpara> <function>array_push</function> вызовет предупреждение, если первый аргумент не является массивом. Это отличается от поведения - конструкции <literal>$var[]</literal>, в случае которой будет создан новый + конструкции <literal>$var[]</literal> до PHP 7.1.0, в случае которой будет создан новый массив. </simpara> </note> diff --git a/reference/strings/functions/explode.xml b/reference/strings/functions/explode.xml index 55d1940df..d8f4e74b2 100644 --- a/reference/strings/functions/explode.xml +++ b/reference/strings/functions/explode.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: shein Status: ready --> +<!-- EN-Revision: 923fbe06539286e2a9261ea9982e788b4157ad48 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.explode" xmlns="http://docbook.org/ns/docbook"> @@ -66,9 +66,8 @@ </para> <note> <para> - По историческим причинам, функции <function>implode</function> можно - передавать аргументы в любом порядке, но для <function>explode</function> - это недопустимо. Убедитесь в том, что <parameter>separator</parameter> + До PHP 8.0 функция <function>implode</function> принимала параметры в любом порядке. + Функция <function>explode</function> никогда этого не поддерживала: убедитесь в том, что <parameter>separator</parameter> указан перед аргументом <parameter>string</parameter>. </para> </note> diff --git a/reference/strings/functions/number-format.xml b/reference/strings/functions/number-format.xml index 5ba74cf19..c0f0bad06 100644 --- a/reference/strings/functions/number-format.xml +++ b/reference/strings/functions/number-format.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 3e15d2894fb35432d2a111db36fe8ba8ebc62024 Maintainer: irker Status: ready --> +<!-- EN-Revision: 2a7c919451f9a536431ba2117f8f90ae814c1c5f Maintainer: irker Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.number-format" xmlns:xlink="http://www.w3.org/1999/xlink"> +<refentry xml:id="function.number-format" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>number_format</refname> <refpurpose>Форматирует число с разделением групп</refpurpose> @@ -12,35 +12,13 @@ &reftitle.description; <methodsynopsis> <type>string</type><methodname>number_format</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam><type>float</type><parameter>num</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>decimals</parameter><initializer>0</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>decimal_separator</parameter><initializer>"."</initializer></methodparam> + <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>thousands_separator</parameter><initializer>","</initializer></methodparam> </methodsynopsis> - <methodsynopsis> - <type>string</type><methodname>number_format</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - <methodparam><type>int</type><parameter>decimals</parameter><initializer>0</initializer></methodparam> - <methodparam><type>string</type><parameter>dec_point</parameter><initializer>"."</initializer></methodparam> - <methodparam><type>string</type><parameter>thousands_sep</parameter><initializer>","</initializer></methodparam> - </methodsynopsis> - <para> - Функция принимает один, два или четыре аргумента (не три): - </para> - <para> - Если передан только один аргумент, <parameter>number</parameter> - будет отформатирован без дробной части, но с запятой (",") между - каждыми тремя цифрами. - </para> <para> - Если переданы два аргумента, <parameter>number</parameter> будет - отформатирован с <parameter>decimals</parameter> знаками после точки - (".") и с запятой (",") между каждыми тремя цифрами. - </para> - <para> - Если переданы все четыре аргумента, <parameter>number</parameter> - будет отформатирован с <parameter>decimals</parameter> знаками после - точки и с разделителем между каждыми тремя цифрами, при этом в качестве - десятичной точки будет использован <parameter>dec_point</parameter>, - а в качестве разделителя групп - <parameter>thousands_sep</parameter>. + Форматирует число сгруппированными тысячами и, возможно, десятичными цифрами. </para> </refsect1> @@ -49,7 +27,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>number</parameter></term> + <term><parameter>num</parameter></term> <listitem> <para> Форматируемое число. @@ -61,11 +39,13 @@ <listitem> <para> Устанавливает число знаков после запятой. + Если <literal>0</literal>, <parameter>decimal_separator</parameter> + опускается в возвращаемом значении. </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>dec_point</parameter></term> + <term><parameter>decimal_separator</parameter></term> <listitem> <para> Устанавливает разделитель дробной части. @@ -73,7 +53,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>thousands_sep</parameter></term> + <term><parameter>thousands_separator</parameter></term> <listitem> <para> Устанавливает разделитель тысяч. @@ -87,7 +67,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Отформатированное число <parameter>number</parameter>. + Отформатированное число <parameter>num</parameter>. </para> </refsect1> @@ -105,11 +85,18 @@ </thead> <tbody> <row> + <entry>8.0.0</entry> + <entry> + До этой версии функция <function>number_format</function> принимала один, + два или четыре параметра (но не три). + </entry> + </row> + <row> <entry>7.2.0</entry> <entry> <function>number_format</function> была изменена, чтобы не возвращать <literal>-0</literal>, ранее <literal>-0</literal> могло быть возвращено в - случаях, когда <parameter>number</parameter> был <literal>-0.01</literal>. + случаях, когда <parameter>num</parameter> был <literal>-0.01</literal>. </entry> </row> </tbody> diff --git a/reference/strings/functions/parse-str.xml b/reference/strings/functions/parse-str.xml index f0cf067b7..cae233f5e 100644 --- a/reference/strings/functions/parse-str.xml +++ b/reference/strings/functions/parse-str.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: shein Status: ready --> +<!-- EN-Revision: 4a7ddddc27271967b616ad3400cfbe2a9b48212b Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.parse-str" xmlns="http://docbook.org/ns/docbook"> @@ -49,15 +49,6 @@ крайне <emphasis>НЕ РЕКОМЕНДУЕТСЯ</emphasis>. Подобное использование объявлено <emphasis>УСТАРЕВШИМ</emphasis> с PHP 7.2. </para> - <para> - Динамическое задание переменных в области функции ведёт ровно к тем же - проблемам, что и <link linkend="ini.register-globals">register_globals</link>. - </para> - <para> - Читайте секцию про безопасность раздела - <link linkend="security.globals">Использование Register Globals</link>, в которой - описывается опасность их использования. - </para> </warning> </listitem> </varlistentry>