Update to En collect.xml + infostyle

This commit is contained in:
Mikhail Alferov
2024-09-27 15:04:53 +03:00
committed by GitHub
parent e9d50905c6
commit 4ca3440006

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b694084174d9bb9432d5ae0d405e43482e6cfb67 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 0545e305cf06937b14b3f0694d6e716c9881ffd7 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="pool.collect" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -15,7 +15,7 @@
<methodparam choice="opt"><type>Callable</type><parameter>collector</parameter></methodparam>
</methodsynopsis>
<para>
Позволяет пулу собирать ссылки, определённые как мусор дополнительным сборщиком.
Метод разрешает пулу собирать ссылки, которые определились как мусор, дополнительным сборщиком.
</para>
</refsect1>
@ -26,8 +26,9 @@
<term><parameter>collector</parameter></term>
<listitem>
<para>
Callback-функция сборщика, которая возвращает логическое значение, указывающее, может ли задача быть собрана или нет.
Только в редких случаях может потребоваться специальный сборщик.
Callback-функция сборщика, которая возвращает логическое значение,
которое указывает, собирать ли задачу.
Пользовательский сборщик требуется только в редких случаях.
</para>
</listitem>
</varlistentry>
@ -37,7 +38,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Количество оставшихся задач в пуле, которые нужно собрать.
Метод возвращает количество задач в пуле, которое осталось собрать.
</para>
</refsect1>
@ -54,7 +55,7 @@
</thead>
<tbody>
<row>
<entry>v3</entry>
<entry>PECL-модуль pthreads 3.0.0</entry>
<entry>
Теперь возвращается целое число, а параметр
<parameter>collector</parameter> теперь необязателен.
@ -70,19 +71,22 @@
&reftitle.examples;
<para>
<example>
<title>Простой пример использования <methodname>Pool::collect</methodname></title>
<title>Простой пример сборки ссылок методом <methodname>Pool::collect</methodname></title>
<programlisting role="php">
<![CDATA[
<?php
$pool = new Pool(4);
for ($i = 0; $i < 15; ++$i) {
$pool->submit(new class extends Threaded {});
}
while ($pool->collect()); // до тех пор, пока все задачи не закончат выполнение
while ($pool->collect()); // Пока каждая задача не закончит выполнение
$pool->shutdown();
?>
]]>
</programlisting>
</example>