com doc/ru: Improve translation for named arguments: appendices/migration80/new-features.xml language/functions.xml

Commit: 5842fd12101b42961b562688da71fd2469bddc7d Author: Alexey Pyltsyn <lex61rus@gmail.com> Sun, 3 Jan 2021 00:13:00 +0300 Parents: 05ef9fa99467b2067f333a5893a31320f35114b3 Branches: master Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=5842fd12101b42961b562688da71fd2469bddc7d Log: Improve translation for named arguments Changed paths: M appendices/migration80/new-features.xml M language/functions.xml Diff: diff --git a/appendices/migration80/new-features.xml b/appendices/migration80/new-features.xml index dfb8b7db5..4e9bfdd53 100644 --- a/appendices/migration80/new-features.xml +++ b/appendices/migration80/new-features.xml @@ -14,7 +14,7 @@ <para> <!-- RFC: https://wiki.php.net/rfc/named_params --> - Добавлена поддержка <link linkend="functions.named-arguments">Именованных аргументов</link>. + Добавлена поддержка <link linkend="functions.named-arguments">именованных аргументов</link>. </para> </sect3> diff --git a/language/functions.xml b/language/functions.xml index e85ed2c40..6d330e5e8 100644 --- a/language/functions.xml +++ b/language/functions.xml @@ -598,18 +598,18 @@ echo sum(1, 2, 3, 4); <title>Именованные аргументы</title> <para> - В PHP 8.0.0 представлены именованные аргументы как расширение существующих - позиционных параметров. Именованные аргументы позволяют передавать аргументы - функции на основе имени параметра, а не позиции параметра. - Это делает значение аргумента самодокументированным, делает аргументы независимыми от - порядка и позволяет произвольно пропускать значения по умолчанию. + В PHP 8.0.0 в виде продолжения позиционных параметров появились именованные аргументы. + С помощью их помощью аргументы + функции можно передавать по имени параметра, а не по его позиции. + Таким образом аргумент становится самодокументированным, независимым от + порядка и указанного значения по умолчанию. </para> <para> - Именованные аргументы передаются с помощью префикса значения с именем параметра, - за которым следует двоеточие. Допускается использование зарезервированных ключевых слов в качестве имен параметров. - Имя параметра должно быть идентификатором, динамическое указание - не допускается. + Именованные аргументы передаются путём добавления через двоеточия имени параметра перед его значением. + В качестве имен параметров можно использовать зарезервированные ключевые слова. + Имя параметра должно быть идентификатором, т.е. он не может быть создан + динамически. </para> <example> @@ -620,7 +620,7 @@ echo sum(1, 2, 3, 4); myFunction(paramName: $value); array_foobar(array: $value); -// НЕ поддерживается +// НЕ поддерживается. function_name($variableStoringParamName: $value); ?> ]]> @@ -628,7 +628,7 @@ function_name($variableStoringParamName: $value); </example> <example> - <title>Позиционные аргументы против именованных аргументов</title> + <title>Позиционные аргументы в сравнении с именованными аргументами</title> <programlisting role="php"> <![CDATA[ <?php @@ -643,11 +643,11 @@ array_fill(start_index: 0, num: 100, value: 50); </example> <para> - Порядок, в котором передаются названные аргументы, не имеет значения. + Порядок, в котором передаются именованные аргументы, не имеет значения. </para> <example> - <title>Тот же пример, что и выше, с другим порядком параметров</title> + <title>Тот же пример, что и выше, но с другим порядком параметров</title> <programlisting role="php"> <![CDATA[ <?php @@ -658,9 +658,9 @@ array_fill(value: 50, num: 100, start_index: 0); </example> <para> - Именованные аргументы можно комбинировать с позиционными аргументами. В этом случае - именованные аргументы должны идти после позиционных аргументов. - Также возможно указать только некоторые из необязательных аргументов + Именованные аргументы можно комбинировать с позиционными. В этом случае + именованные аргументы должны следовать после позиционных аргументов. + Также возможно передать только часть необязательных аргументов функции, независимо от их порядка. </para> @@ -682,7 +682,7 @@ htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false); </para> <example> - <title>Исключение Error при передаче одного и того же параметра несколько раз</title> + <title>Выбрасывание исключения Error при передаче одного и того же параметра несколько раз</title> <programlisting role="php"> <![CDATA[ <?php