Generator: improvements

git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@343687 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Alexey Pyltsyn
2017-12-22 13:05:54 +00:00
parent 2f342757f2
commit e85d013258
10 changed files with 34 additions and 32 deletions

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cfcdab37fdd13a27a84251c7526bc7996d0b112c Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<phpdoc:classref xml:id="class.generator" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Generator</title>
<titleabbrev>Генератор</titleabbrev>
<titleabbrev>Generator</titleabbrev>
<partintro>

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8f10aa0448edc12d203fd868d690d0dbbdc9d39d Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.current" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::current</refname>
<refpurpose>Возвращает текущее значение генератора</refpurpose>
<refpurpose>Получить текущее значение генератора</refpurpose>
</refnamediv>
<refsect1 role="description">

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.getreturn" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -24,7 +24,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Получает возвращаемое значение генератора, после того, как он закончился.
Получает возвращаемое значение генератора, после его завершения.
</para>
</refsect1>

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 86ef66a5585edc5007828445823647096ee7037a Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.key" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::key</refname>
<refpurpose>Возвращает ключ сгенерированного элемента</refpurpose>
<refpurpose>Получить ключ сгенерированного элемента</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,7 +15,7 @@
<void />
</methodsynopsis>
<para>
Возвращает ключ сгенерированного элемента.
Получает ключ сгенерированного элемента.
</para>
</refsect1>

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8f10aa0448edc12d203fd868d690d0dbbdc9d39d Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.next" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::next</refname>
<refpurpose>Возобновляет работу генератора</refpurpose>
<refpurpose>Возобновить работу генератора</refpurpose>
</refnamediv>
<refsect1 role="description">

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8f10aa0448edc12d203fd868d690d0dbbdc9d39d Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::rewind</refname>
<refpurpose>Перематывает итератор</refpurpose>
<refpurpose>Перемотать итератор</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -15,7 +15,7 @@
<void />
</methodsynopsis>
<para>
Если итерация уже начата, то бросает исключение.
Если итерация уже начата, то выбрасывает исключение.
</para>
</refsect1>

View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e347a6856ebf825de819b7ca28c510b961a33e07 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.send" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::send</refname>
<refpurpose>Передача значения в генератор</refpurpose>
<refpurpose>Передать значение в генератор</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -21,8 +21,8 @@
<para>
Если генератор еще не дошел до первого вызова оператора &yield;, он выполнится до
момента первого вызова &yield;, прежде чем передаст в него значение.
Так что нет необходимости вызывать <methodname>Generator::next</methodname>
нового генератора перед вызовом этого метода (как это делается в Python).
Так что нет необходимости вызывать генератор с помощью <methodname>Generator::next</methodname>
перед вызовом этого метода (как это делается в Python).
</para>
</refsect1>
@ -33,8 +33,8 @@
<term><parameter>value</parameter></term>
<listitem>
<para>
Значение, которое отправляется в генератор. Это значение будет также и текущим
возвращаемым значение генератора.
Значение, которое отправляется в генератор. Это значение будет текущим
возвращаемым значением &yield; генератора.
</para>
</listitem>
</varlistentry>
@ -52,14 +52,15 @@
&reftitle.examples;
<para>
<example>
<title>Использование <methodname>Generator::send</methodname> для инъекции значений</title>
<title>Использование <methodname>Generator::send</methodname> для внедрения значений</title>
<programlisting role="php">
<![CDATA[
<?php
function printer() {
echo "I'm printer!".PHP_EOL;
while (true) {
$string = yield;
echo $string."\n";
echo $string.PHP_EOL;
}
}
@ -72,6 +73,7 @@ $printer->send('Bye world!');
&example.outputs;
<screen>
<![CDATA[
I'm printer!
Hello world!
Bye world!
]]>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: efdc9e6334e88031f3d3539f9271e69b60088cbc Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.throw" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -20,8 +20,8 @@
выражение <literal>throw $exception</literal>.
</para>
<para>
Если к моменту вызова этого метода генератор уже будет закрыт, исключение
будет брошено в контекесте вызывающего кода.
Если к моменту вызова этого метода генератор закрыт, исключение
будет выброшено в контексте вызывающего кода.
</para>
</refsect1>
@ -32,7 +32,7 @@
<term><parameter>exception</parameter></term>
<listitem>
<para>
Исключение, которое надо бросить в генератор.
Исключение, которое надо выбросить в генератор.
</para>
</listitem>
</varlistentry>
@ -42,7 +42,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает сгенерированное значение..
Возвращает сгенерированное значение.
</para>
</refsect1>
@ -74,7 +74,7 @@
&reftitle.examples;
<para>
<example>
<title>Передача исключения в итератор</title>
<title>Выбрасывание исключения в итератор</title>
<programlisting role="php">
<![CDATA[
<?php

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8f10aa0448edc12d203fd868d690d0dbbdc9d39d Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.valid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -24,7 +24,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает &false; если итератор закрыт и &true; в обратном случае.
Возвращает &false;, если итератор закрыт и &true; в обратном случае.
</para>
</refsect1>

View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8f10aa0448edc12d203fd868d690d0dbbdc9d39d Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<!-- Reviewed: yes Maintainer: lex -->
<!-- $Revision$ -->
<refentry xml:id="generator.wakeup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@ -15,7 +15,7 @@
<void />
</methodsynopsis>
<para>
Бросает исключение, так как генератор нельзя сериализовать.
Бросает исключение, поскольку генераторы не могут быть сериализованы.
</para>
</refsect1>