VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-16 18:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

upd

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@342579 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Andrey Gromov
2017-06-10 16:58:12 +00:00
parent ed7e97110c
commit ebd49b6cf1
4 changed files with 118 additions and 89 deletions
Download Patch File Download Diff File Expand all files Collapse all files

114
language/generators.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c4910a6ef8b2864f34abf09924a1333af54cdb48 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 3f74beaf6b9dfb3b1edf07b9598d21f9e94f7b4e Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
<chapter xml:id="language.generators" xmlns="http://docbook.org/ns/docbook">
@ -381,45 +381,45 @@ foreach (gen_reference() as &$number) {
<sect3 xml:id="control-structures.yield.from">
<title>Делегирование генератора с помощью <command>yield from</command></title>
<para>
В PHP 7, делегирование генератора позволяет вам получать значения из
другого генератора, объекта <classname>Traversable</classname>, или массива,
используя <command>yield from</command>.
Внешний генератор будет возвращать значения из внутреннего генератора,
объекта или массива, до того момента, пока они их отдают, после чего
продолжится выполнения внешнего генератора.
</para>
<para>
Если генератор используется с <command>yield from</command>, то выражение
<command>yield from</command> также будет возвращать значения из
внутреннего генератора.
</para>
<caution>
<title>Сохранение в массив (т.е. <function>iterator_to_array</function>)</title>
<para>
<command>yield from</command> не сбрасывает ключи. Ключи, возвращенные
из объекта <classname>Traversable</classname> или массива, сохранятся.
Таким образом, некоторые значения, могут пересекаться по ключам с другими
<command>yield</command> или <command>yield from</command>, что, при записи
в массив, повлечет за собой перезапись уже записанных значений.
В PHP 7, делегирование генератора позволяет вам получать значения из
другого генератора, объекта <classname>Traversable</classname>, или массива,
используя <command>yield from</command>.
Внешний генератор будет возвращать значения из внутреннего генератора,
объекта или массива, до того момента, пока они их отдают, после чего
продолжится выполнения внешнего генератора.
</para>
<para>
Общий случай, когда это имеет значение, это когда <function>iterator_to_array</function>
возвращает массив с ключами по умолчанию. В этом случае можно получить
печальный результат. <function>iterator_to_array</function> имеет второй параметр
<parameter>use_keys</parameter>, который можно установить в &false;, для
генерации собственных ключей и игнорировании ключей,
переданных из объекта <classname>Generator</classname>.
Если генератор используется с <command>yield from</command>, то выражение
<command>yield from</command> также будет возвращать значения из
внутреннего генератора.
</para>
<example>
<title><command>yield from</command> с <function>iterator_to_array</function></title>
<programlisting role="php">
<caution>
<title>Сохранение в массив (т.е. <function>iterator_to_array</function>)</title>
<para>
<command>yield from</command> не сбрасывает ключи. Ключи, возвращенные
из объекта <classname>Traversable</classname> или массива, сохранятся.
Таким образом, некоторые значения, могут пересекаться по ключам с другими
<command>yield</command> или <command>yield from</command>, что, при записи
в массив, повлечет за собой перезапись уже записанных значений.
</para>
<para>
Общий случай, когда это имеет значение, это когда <function>iterator_to_array</function>
возвращает массив с ключами по умолчанию. В этом случае можно получить
печальный результат. <function>iterator_to_array</function> имеет второй параметр
<parameter>use_keys</parameter>, который можно установить в &false;, для
генерации собственных ключей и игнорировании ключей,
переданных из объекта <classname>Generator</classname>.
</para>
<example>
<title><command>yield from</command> с <function>iterator_to_array</function></title>
<programlisting role="php">
<![CDATA[
<?php
function from() {
@ -436,9 +436,9 @@ function gen() {
var_dump(iterator_to_array(gen()));
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(3) {
[0]=>
@ -449,13 +449,13 @@ array(3) {
int(3)
}
]]>
</screen>
</example>
</caution>
<example>
<title>Основы использования <command>yield from</command></title>
<programlisting role="php">
</screen>
</example>
</caution>
<example>
<title>Основы использования <command>yield from</command></title>
<programlisting role="php">
<![CDATA[
<?php
function count_to_ten() {
@ -482,18 +482,18 @@ foreach (count_to_ten() as $num) {
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
1 2 3 4 5 6 7 8 9 10
]]>
</screen>
</example>
<example>
<title><command>yield from</command> и возвращаемые значения</title>
<programlisting role="php">
</screen>
</example>
<example>
<title><command>yield from</command> и возвращаемые значения</title>
<programlisting role="php">
<![CDATA[
<?php
function count_to_ten() {
@ -526,14 +526,14 @@ foreach ($gen as $num) {
echo $gen->getReturn();
?>
]]>
</programlisting>
&example.outputs;
<screen>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
1 2 3 4 5 6 7 8 9 10
]]>
</screen>
</example>
</screen>
</example>
</sect3>
</sect2>
</sect1>

16
reference/imagick/setup.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f11d35003d1eedcc54f2afc0e91aaf365de0be38 Maintainer: alien Status: ready -->
<!-- EN-Revision: 077349a92eaaa9cff7e31eb968f2e2bb0f4cdb0f Maintainer: alien Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
<chapter xml:id="imagick.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="imagick.requirements">
&reftitle.required;
@ -17,19 +17,19 @@
<emphasis>Windows</emphasis> без необходимости компилирования.
</para>
</section>
<section xml:id="imagick.requirements.nix">
<title>Требования к установке на другие платформы</title>
<para>
Требуется PHP &gt;= 5.1.3 и ImageMagick &gt;= 6.2.4. Количество
поддерживаемых форматов Imagick зависит от количества поддерживаемых
поддерживаемых Imagick форматов файлов зависит от количества поддерживаемых
форматов установленного ImageMagick. Например, Imagemagick требует
ghostscript для проведения операций с PDF документами.
</para>
</section>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
<section xml:id="imagick.installation">
&reftitle.install;
@ -48,16 +48,16 @@
</para>
</section>
<!-- }}} -->
&reference.imagick.ini;
<!-- {{{ Resources -->
<section xml:id="imagick.resources">
&reftitle.resources;
&no.resource;
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file

73
reference/ldap/functions/ldap-get-option.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4e4ab8c161feb9893167d59a316d4fbfcc864e79 Maintainer: mch Status: ready -->
<!-- EN-Revision: 27a75ae3cb498f48757ae7b08a36717cdb1be08c Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: no -->
<refentry xml:id="function.ldap-get-option" xmlns="http://docbook.org/ns/docbook">
@ -20,7 +20,7 @@
Устанавливает <parameter>retval</parameter> в значение указанной опции.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
@ -44,135 +44,164 @@
<row>
<entry>Опция</entry>
<entry>Тип</entry>
<entry>Начиная с версии</entry>
</row>
</thead>
<tbody>
<row>
<entry><constant>LDAP_OPT_DEREF</constant></entry>
<entry>integer</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_SIZELIMIT</constant></entry>
<entry>integer</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_TIMELIMIT</constant></entry>
<entry>integer</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_NETWORK_TIMEOUT</constant></entry>
<entry>integer</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_PROTOCOL_VERSION</constant></entry>
<entry>integer</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_ERROR_NUMBER</constant></entry>
<entry>integer</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_REFERRALS</constant></entry>
<entry>bool</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_RESTART</constant></entry>
<entry>bool</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_HOST_NAME</constant></entry>
<entry>string</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_ERROR_STRING</constant></entry>
<entry>string</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_MATCHED_DN</constant></entry>
<entry>string</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_SERVER_CONTROLS</constant></entry>
<entry>array</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_CLIENT_CONTROLS</constant></entry>
<entry>array</entry>
<entry></entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_KEEPALIVE_IDLE</constant></entry>
<entry>int</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_KEEPALIVE_PROBES</constant></entry>
<entry>int</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_KEEPALIVE_INTERVAL</constant></entry>
<entry>int</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CACERTDIR</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CACERTFILE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CERTFILE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CIPHER_SUITE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CRLCHECK</constant></entry>
<entry>integer</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CRL_NONE</constant></entry>
<entry>integer</entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CRL_PEER</constant></entry>
<entry>integer</entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CRL_ALL</constant></entry>
<entry>integer</entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_CRLFILE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_DHFILE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_KEYILE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_PACKAGE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_PROTOCOL_MIN</constant></entry>
<entry>integer</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_RANDOM_FILE</constant></entry>
<entry>string</entry>
<entry></entry>
<entry>7.1</entry>
</row>
<row>
<entry><constant>LDAP_OPT_X_TLS_REQUIRE_CERT</constant></entry>
<entry>integer</entry>
<entry></entry>
<entry>7.1</entry>
</row>
</tbody>
</tgroup>
@ -191,14 +220,14 @@
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@ -219,7 +248,7 @@ if (ldap_get_option($ds, LDAP_OPT_PROTOCOL_VERSION, $version)) {
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
@ -228,7 +257,7 @@ if (ldap_get_option($ds, LDAP_OPT_PROTOCOL_VERSION, $version)) {
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
@ -237,7 +266,7 @@ if (ldap_get_option($ds, LDAP_OPT_PROTOCOL_VERSION, $version)) {
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

4
reference/pcre/functions/preg-match.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 952a9acd7219e3c5b5b9ed5c8e2a1b1284eee443 Maintainer: shein Status: ready -->
<!-- EN-Revision: 90251a0f835f7599d16513a4b5d0d0c357c8733d Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.preg-match" xmlns="http://docbook.org/ns/docbook">
@ -191,7 +191,7 @@ Array
</screen>
<para>
В качестве альтернативы <literal>substr()</literal>, используйте
<literal>\G</literal> вместо якоря <literal>^</literal>,
утверждение <literal>\G</literal> вместо якоря <literal>^</literal>,
или модификатор <literal>A</literal>. Оба они работают с параметром <parameter>offset</parameter>.
</para>
</informalexample>