diff --git a/reference/pthreads/book.xml b/reference/pthreads/book.xml index 0a3e60424..a8a40a6ab 100644 --- a/reference/pthreads/book.xml +++ b/reference/pthreads/book.xml @@ -1,17 +1,17 @@ - + - + pthreads pthreads &reftitle.intro; - + pthreads предоставляет объектно-ориентированный API для работы с многопоточностью в PHP. Приложения на PHP могут создавать, читать, записывать, запускать и выполнять синхронизацию с объектами Threads, Workers и Threaded. - + Модуль считается неподдерживаемым и мёртвым. @@ -23,23 +23,23 @@ - + Модуль доступен только для CLI-приложений. Исходя из этого, многопоточность в PHP в окружении веб-сервера недоступна. - + - + pthreads (v3) может использоваться только с PHP 7.2 и выше, так как ZTS-режим нестабилен в 7.0 и 7.1. - + - + Класс Threaded предоставляет базовый функционал, необходимый для работы pthreads. Он предоставляет методы синхронизации и некоторые полезные для разработчика интерфейсы. - - + + Класс Thread позволяет создавать потоки. Для создания потока необходимо создать наследующие его класс и в нём реализовать метод run. @@ -50,8 +50,8 @@ метод Thread::start из контекста, в котором он был создан. Стартовать и присоединить поток можно только в том контексте, где он был создан. - - + + Класс Worker имеет постоянное состояние и будет доступен из метода Thread::start (унаследованный метод) до тех пор, пока объект не выйдет из @@ -64,30 +64,30 @@ будет запущен раньше, чем любой объект с его стека задач, что даёт возможность инициализировать необходимые для задачи ресурсы. - - + + Класс Pool используется для создания группы исполнителей (worker) для распределения между ними объектов Threaded. Это самый простой и эффективный вариант использования многопоточности в PHP. - + - + Класс Pool не наследует Threaded, таким образом являясь обычным объектом PHP. Объекты этого класса не должны разделяться по различным контекстам. - + - + Класс Volatile добавлен в pthreads v3. Он используется для задания изменяемых Threaded-свойств классов типа Threaded (так как теперь они по умолчанию неизменяемы). Также используется для хранения массивов PHP в контексте Threaded. - - + + Синхронизация - важная часть многопоточности. Все объекты, созданные pthreads, имеют встроенные методы для обеспечения синхронизации (они покажутся очень знакомыми для разработчиков @@ -98,15 +98,15 @@ Threaded::notify для ожидающего объекта. Этот механизм позволяет осуществлять синхронизацию между объектами Threaded. - + - + Любые объекты вашего приложения, которые предполагается использовать в многопоточном режиме, должны наследовать Threaded. - + - + Хранение данных: Как правило, в объекте Threaded можно использовать любые данные, которые могут быть сериализованы. Они могут быть записаны и прочтены из @@ -120,8 +120,8 @@ для установки свойства в Threaded-объекте отделены от ссылок внутри Threaded-объекте. Чтение тех же данных можно производить напрямую из любого контекста по ссылке на Threaded-объекте. - - + + Статические свойства: Когда создаётся новый контекст (Thread или Worker), они просто копируются, но ресурсы и объекты обнуляются (из соображения безопасности). Это @@ -131,15 +131,15 @@ информация необходимая для соединения, но не само соединение. Это позволит создать новое соединение в новом контексте и сохранить его в том же месте никак не затрагивая оригинальный контекст. - + - + Когда запускаются print_r, var_dump или другие отладочные функции, они не включают защиту от рекурсии. - + - + Ресурсы: Модули и функциональность PHP, создающие ресурсы, совершенно не подготовлены для такого типа окружения; pthreads предоставляет @@ -147,13 +147,13 @@ для большинства типов ресурсов его следует считать небезопасным. Разделяя ресурс между контекстами необходимо быть крайне внимательным и осторожным. - + - + В окружении, где запускается pthreads, необходимы некоторые ограничения и запреты для обеспечения стабильности. - + @@ -166,7 +166,8 @@ &reference.pthreads.pool; &reference.pthreads.volatile; - + - + Интерфейс Collectable Collectable @@ -10,9 +10,9 @@
&reftitle.intro; - + Представляет объект, который можно собрать сборщиком мусора. - +
@@ -32,7 +32,7 @@ &Methods; - + diff --git a/reference/pthreads/collectable/isgarbage.xml b/reference/pthreads/collectable/isgarbage.xml index b9307d331..2839b2132 100644 --- a/reference/pthreads/collectable/isgarbage.xml +++ b/reference/pthreads/collectable/isgarbage.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ public trueCollectable::isGarbage - + Можно вызывать в Pool::collect для определения, является ли объект мусором. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + &return.true.always; - + diff --git a/reference/pthreads/configure.xml b/reference/pthreads/configure.xml index a67ef06b8..0f3603bcc 100644 --- a/reference/pthreads/configure.xml +++ b/reference/pthreads/configure.xml @@ -1,25 +1,24 @@ - + - -
+
&reftitle.install; - + Используйте флаг при компиляции PHP. - + - + Пользователям Windows необходимо включить php_pthreads.dll в &php.ini; - + - + Для Windows также необходимо убедиться, что pthreadVC2.dll (входит в дистрибутив) присутствует в одном из каталогов, включённых в переменную окружения PATH. - +
diff --git a/reference/pthreads/pool.xml b/reference/pthreads/pool.xml index 01abcb158..e007723a5 100644 --- a/reference/pthreads/pool.xml +++ b/reference/pthreads/pool.xml @@ -1,7 +1,7 @@ - + - + Класс Pool Pool @@ -11,14 +11,14 @@
&reftitle.intro; - + Объект Pool является контейнером для хранения объектов Worker, управления ими и регулирования их количества. - - + + Контейнеризация представляет собой высший уровень абстракции над функционалом Worker включая управление ссылками в корректном для pthreads виде. - +
@@ -79,31 +79,31 @@ size - максимальное количество объектов Worker + максимальное количество объектов Worker class - класс Worker + класс Worker workers - ссылки на объекты Worker + ссылки на объекты Worker ctor - аргументы конструктора новых объектов Worker + аргументы конструктора новых объектов Worker last - смещение последнего использованного Worker в workers + смещение последнего использованного Worker в workers diff --git a/reference/pthreads/pool/collect.xml b/reference/pthreads/pool/collect.xml index 97782004c..3fc9fe1e4 100644 --- a/reference/pthreads/pool/collect.xml +++ b/reference/pthreads/pool/collect.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intPool::collect Callablecollector - + Метод разрешает пулу собирать ссылки, которые определились как мусор, дополнительным сборщиком. - + @@ -24,11 +24,11 @@ collector - + Callback-функция сборщика, которая возвращает логическое значение, которое указывает, собирать ли задачу. Пользовательский сборщик требуется только в редких случаях. - + @@ -36,9 +36,9 @@ &reftitle.returnvalues; - + Метод возвращает количество задач в пуле, которое осталось собрать. - + diff --git a/reference/pthreads/pool/construct.xml b/reference/pthreads/pool/construct.xml index 9390fd553..8facd2f38 100644 --- a/reference/pthreads/pool/construct.xml +++ b/reference/pthreads/pool/construct.xml @@ -1,5 +1,5 @@ - + @@ -15,11 +15,11 @@ stringclass arrayctor - + Создаёт новый пул рабочих. Пулы лениво создают свои потоки, что означает, что новые потоки будут создаваться только тогда, когда они необходимы для выполнения заданий. - + @@ -28,26 +28,26 @@ size - + Максимальное количество воркеров, которое может создать этот пул - + class - + Класс для новых воркеров. Если класс не указан, то по умолчанию используется класс Worker. - + ctor - + Массив аргументов для передачи конструкторам новых воркерам. - + diff --git a/reference/pthreads/pool/resize.xml b/reference/pthreads/pool/resize.xml index 24ab9b90e..9102bc7c8 100644 --- a/reference/pthreads/pool/resize.xml +++ b/reference/pthreads/pool/resize.xml @@ -1,8 +1,7 @@ - + - - + Pool::resize Изменяет размер пула @@ -14,9 +13,9 @@ public voidPool::resize intsize - + Изменяет размер пула - + @@ -25,9 +24,9 @@ size - + Максимальное количество воркеров, которое может создать этот пул - + @@ -35,9 +34,9 @@ &reftitle.returnvalues; - + &return.void; - + + @@ -13,10 +13,10 @@ public voidPool::shutdown - + Выключает всех воркеров в пуле. Будет заблокировано до тех пор, пока все отправленные задачи не будут выполнены. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + &return.void; - + diff --git a/reference/pthreads/pool/submit.xml b/reference/pthreads/pool/submit.xml index e5121d218..304b624ac 100644 --- a/reference/pthreads/pool/submit.xml +++ b/reference/pthreads/pool/submit.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intPool::submit Threadedtask - + Отправляет задание следующему воркеру в пуле - + @@ -24,9 +24,9 @@ task - + Задание для выполнения - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + Идентификатор воркера, выполняющего объект - + diff --git a/reference/pthreads/pool/submitTo.xml b/reference/pthreads/pool/submitTo.xml index a53c982db..4e1e21355 100644 --- a/reference/pthreads/pool/submitTo.xml +++ b/reference/pthreads/pool/submitTo.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,11 @@ intworker Threadedtask - + Отправляет задачу указанному воркеру в пуле. Воркеры индексируются с 0 и будут существовать только в том случае, если пулу необходимо их создать (поскольку потоки создаются лениво). - + @@ -27,17 +27,17 @@ worker - + Воркер, в который нужно добавить задание, начиная с 0. - + task - + Задание для выполнения - + @@ -45,9 +45,9 @@ &reftitle.returnvalues; - + Идентификатор воркера, принявшего задачу. - + diff --git a/reference/pthreads/setup.xml b/reference/pthreads/setup.xml index 139b36364..c66681f4e 100644 --- a/reference/pthreads/setup.xml +++ b/reference/pthreads/setup.xml @@ -1,45 +1,45 @@ - + - + &reftitle.setup;
&reftitle.required; - + Для работы модуля pthreads требуется потокобезопасная сборка PHP с поддержкой режима ZTS (Zend Thread Safety). Сделать это можно при компиляции через ключ или на системах (кроме ОС Windows) до PHP 8.0.0 через ключ . - + - + После компиляции потокобезопасность нельзя включить — это исключительно опция, которая устанавливается на этапе компиляции. - + - + Модуль pthreads можно собрать везде, где присутствуют заголовочные файлы набора интерфейсов Posix Threads (pthread.h) и потокобезопасная сборка PHP, включая Windows (через проект pthread-w32 из redhat). - +
&reftitle.install; - + Готовые сборки pthreads размещают в репозитории PECL, а исходный код на сайте Github. Самый простой путь — установить модуль из PECL: PECL. - - + + Пользователям Windows необходимо загрузить подготовленный бинарный файл с сайта PECL. - + - + Пользователям Windows придётся выполнить дополнительные действия для добавления файла библиотеки pthreadVC2.dll (включается в релизы для Windows) в переменную PATH. - +
diff --git a/reference/pthreads/thread.xml b/reference/pthreads/thread.xml index c2285a9b1..e3035ad8b 100644 --- a/reference/pthreads/thread.xml +++ b/reference/pthreads/thread.xml @@ -1,8 +1,7 @@ - + - - + Класс Thread Thread @@ -12,20 +11,20 @@
&reftitle.intro; - + Когда вызван стартовый метод Thread, код метода run будет запущен в отдельном потоке, параллельно. - - + + После отработки метода run, Thread сразу же завершит работу. Он будет присоединён путём создания Thread в нужное время. - + - + Если полагаться на движок для определения, когда Thread будет присоединён, можно столкнуться с неожиданным поведением. Поэтому необходимо, по возможности, управлять присоединением в явном виде. - +
@@ -63,10 +62,10 @@ &Methods; - + &InheritedMethods; - + diff --git a/reference/pthreads/thread/getcreatorid.xml b/reference/pthreads/thread/getcreatorid.xml index a299f6bcd..eb7993673 100644 --- a/reference/pthreads/thread/getcreatorid.xml +++ b/reference/pthreads/thread/getcreatorid.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intThread::getCreatorId - + Возвращает идентификатор потока, который создал указанный поток. - +
@@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Числовой идентификатор. - + diff --git a/reference/pthreads/thread/getcurrentthread.xml b/reference/pthreads/thread/getcurrentthread.xml index 81169fca7..28b08a423 100644 --- a/reference/pthreads/thread/getcurrentthread.xml +++ b/reference/pthreads/thread/getcurrentthread.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public static ThreadThread::getCurrentThread - + Возвращает ссылку на текущий выполняющийся поток. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + Объект, представляющий текущий выполняющийся поток. - + diff --git a/reference/pthreads/thread/getcurrentthreadid.xml b/reference/pthreads/thread/getcurrentthreadid.xml index f89150c8a..d91edf6f6 100644 --- a/reference/pthreads/thread/getcurrentthreadid.xml +++ b/reference/pthreads/thread/getcurrentthreadid.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public static intThread::getCurrentThreadId - + Возвращает идентификатор текущего выполняющегося потока. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Числовой идентификатор. - + diff --git a/reference/pthreads/thread/getthreadid.xml b/reference/pthreads/thread/getthreadid.xml index 298b2136a..3c2750cfc 100644 --- a/reference/pthreads/thread/getthreadid.xml +++ b/reference/pthreads/thread/getthreadid.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intThread::getThreadId - + Возвращает идентификатор указанного потока - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Числовой идентификатор. - + diff --git a/reference/pthreads/thread/isjoined.xml b/reference/pthreads/thread/isjoined.xml index 1910ae85d..4401c68b4 100644 --- a/reference/pthreads/thread/isjoined.xml +++ b/reference/pthreads/thread/isjoined.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThread::isJoined - + Сообщает, был ли присоединён указанный поток. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/thread/isstarted.xml b/reference/pthreads/thread/isstarted.xml index 48701b11f..4201b3ea1 100644 --- a/reference/pthreads/thread/isstarted.xml +++ b/reference/pthreads/thread/isstarted.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThread::isStarted - + Сообщает, был ли запущен указанный поток. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/thread/join.xml b/reference/pthreads/thread/join.xml index 5983b9b4e..099000d04 100644 --- a/reference/pthreads/thread/join.xml +++ b/reference/pthreads/thread/join.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThread::join - + Заставляет вызывающий контекст ждать, пока указанный поток завершит выполнение. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/thread/start.xml b/reference/pthreads/thread/start.xml index efc2c0abf..2db11c144 100644 --- a/reference/pthreads/thread/start.xml +++ b/reference/pthreads/thread/start.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThread::start intoptions - + Запускает новый поток для выполнения реализованного метода запуска. - + @@ -24,9 +24,9 @@ options - + Необязательная маска констант наследования, по умолчанию PTHREADS_INHERIT_ALL. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/threaded.xml b/reference/pthreads/threaded.xml index f7540aae8..a84048f3a 100644 --- a/reference/pthreads/threaded.xml +++ b/reference/pthreads/threaded.xml @@ -1,8 +1,7 @@ - + - - + Класс Threaded Threaded @@ -12,14 +11,14 @@
&reftitle.intro; - + Объекты Threaded формируют базис способности pthreads запускать пользовательский код в новых потоках. Класс содержит методы синхронизации и различные полезные интерфейсы. - - + + Самое важное, что объекты Threaded обеспечивают безопасность для разработчика. Все операции в контексте объекта - безопасны. - +
@@ -55,7 +54,7 @@ &Methods; - + diff --git a/reference/pthreads/threaded/chunk.xml b/reference/pthreads/threaded/chunk.xml index fd16523e9..ffb5f6ff7 100644 --- a/reference/pthreads/threaded/chunk.xml +++ b/reference/pthreads/threaded/chunk.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ intsize boolpreserve - + Получает фрагмент таблицы свойств объектов заданного размера, при необходимости сохраняя ключи. - +
@@ -25,17 +25,17 @@ size - + Количество элементов для получения. - + preserve - + Сохранять ключи элементов, по умолчанию false. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + Массив элементов из таблицы свойств объектов. - + diff --git a/reference/pthreads/threaded/count.xml b/reference/pthreads/threaded/count.xml index 60b244b28..cefda30a3 100644 --- a/reference/pthreads/threaded/count.xml +++ b/reference/pthreads/threaded/count.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intThreaded::count - + Возвращает количество свойств для этого объекта. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + - + diff --git a/reference/pthreads/threaded/extend.xml b/reference/pthreads/threaded/extend.xml index 03a6ba7ad..2fab4f1dc 100644 --- a/reference/pthreads/threaded/extend.xml +++ b/reference/pthreads/threaded/extend.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThreaded::extend stringclass - + Делает потокобезопасный стандартный класс во время выполнения. - + @@ -24,9 +24,9 @@ class - + Класс для расширения. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/threaded/isrunning.xml b/reference/pthreads/threaded/isrunning.xml index b586dff6e..683f2f92c 100644 --- a/reference/pthreads/threaded/isrunning.xml +++ b/reference/pthreads/threaded/isrunning.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThreaded::isRunning - + Сообщает, выполняется ли указанный объект. - + @@ -28,9 +28,9 @@ Логическое значение состояния объекта. - + Объект считается запущенным при выполнении метода run. - + diff --git a/reference/pthreads/threaded/isterminated.xml b/reference/pthreads/threaded/isterminated.xml index e4765c2fe..b28ef8612 100644 --- a/reference/pthreads/threaded/isterminated.xml +++ b/reference/pthreads/threaded/isterminated.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ public boolThreaded::isTerminated - + Сообщает, был ли объект, на который указывает ссылка, прекращён во время выполнения; произошли ли фатальные ошибки или были выброшены неперехваченные исключения. - + @@ -26,9 +26,9 @@ &reftitle.returnvalues; - + Логическое значение состояния объекта. - + diff --git a/reference/pthreads/threaded/merge.xml b/reference/pthreads/threaded/merge.xml index 9ec3da623..73a68ce67 100644 --- a/reference/pthreads/threaded/merge.xml +++ b/reference/pthreads/threaded/merge.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ mixedfrom booloverwrite - + Объединяет данные в текущий объект. - + @@ -25,17 +25,17 @@ from - + Данные для объединения. - + overwrite - + Перезаписать существующие ключи, по умолчанию true. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/threaded/notify.xml b/reference/pthreads/threaded/notify.xml index d67639887..3c9dad0ea 100644 --- a/reference/pthreads/threaded/notify.xml +++ b/reference/pthreads/threaded/notify.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThreaded::notify - + Отправляет уведомление указанному объекту. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/threaded/notifyone.xml b/reference/pthreads/threaded/notifyone.xml index 944122f23..a2a343297 100644 --- a/reference/pthreads/threaded/notifyone.xml +++ b/reference/pthreads/threaded/notifyone.xml @@ -1,5 +1,5 @@ - + @@ -13,11 +13,11 @@ public boolThreaded::notifyOne - + Отправляет уведомление указанному объекту. Это разблокирует по крайней мере один из заблокированных потоков (в отличие от Threaded::notify с разблокировкой всех потоков). - + @@ -27,9 +27,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/threaded/pop.xml b/reference/pthreads/threaded/pop.xml index 9a544c74c..58a7287c8 100644 --- a/reference/pthreads/threaded/pop.xml +++ b/reference/pthreads/threaded/pop.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThreaded::pop - + Извлекает элемент из таблицы свойств объекта. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Последний элемент из таблицы свойств объектов. - + diff --git a/reference/pthreads/threaded/run.xml b/reference/pthreads/threaded/run.xml index be7abed72..5f50cf777 100644 --- a/reference/pthreads/threaded/run.xml +++ b/reference/pthreads/threaded/run.xml @@ -1,7 +1,7 @@ - + - + Threaded::run Выполнение @@ -11,11 +11,11 @@ &reftitle.description; public voidThreaded::run - + - + Программист всегда должен реализовывать метод run для объектов, которые предназначены для выполнения. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Возвращаемое значение метода, если оно используется, будет проигнорировано. - +
diff --git a/reference/pthreads/threaded/shift.xml b/reference/pthreads/threaded/shift.xml index 44d76ef14..4b23124cd 100644 --- a/reference/pthreads/threaded/shift.xml +++ b/reference/pthreads/threaded/shift.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public mixedThreaded::shift - + Перемещает элемент из таблицы свойств объекта. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Первый элемент из таблицы свойств объекта. - + diff --git a/reference/pthreads/threaded/synchronized.xml b/reference/pthreads/threaded/synchronized.xml index b7d1426ae..563f12ea7 100644 --- a/reference/pthreads/threaded/synchronized.xml +++ b/reference/pthreads/threaded/synchronized.xml @@ -1,5 +1,5 @@ - + @@ -14,9 +14,9 @@ Closureblock mixedargs - + Выполняет блок, сохраняя блокировку синхронизации ссылочных объектов для вызывающего контекста. - + @@ -25,17 +25,17 @@ block - + Блок кода для выполнения. - + args - + Список аргументов переменной длины для использования в качестве аргументов функции блока. - + @@ -43,9 +43,9 @@ &reftitle.returnvalues; - + Возвращаемое значение блока. - + diff --git a/reference/pthreads/threaded/wait.xml b/reference/pthreads/threaded/wait.xml index 287bbcd6c..0b94024d7 100644 --- a/reference/pthreads/threaded/wait.xml +++ b/reference/pthreads/threaded/wait.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolThreaded::wait inttimeout - + Заставляет вызывающий контекст ждать уведомления от указанного объекта. - + @@ -24,9 +24,9 @@ timeout - + Необязательный параметр времени ожидания в микросекундах. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/volatile.xml b/reference/pthreads/volatile.xml index e783d5a1d..55d335449 100644 --- a/reference/pthreads/volatile.xml +++ b/reference/pthreads/volatile.xml @@ -1,7 +1,7 @@ - + - + Класс Volatile Volatile @@ -11,14 +11,14 @@
&reftitle.intro; - + Класс Volatile появился в pthreads v3. Его введение является следствием новой семантики неизменности Threaded-свойств классов Threaded. Класс Volatile включает иммутабельность их Threaded-свойств и, также, используется для хранения массивов PHP в контексте Threaded. - +
@@ -51,7 +51,7 @@ &InheritedMethods; - + diff --git a/reference/pthreads/worker.xml b/reference/pthreads/worker.xml index b188b8fe5..828f09160 100644 --- a/reference/pthreads/worker.xml +++ b/reference/pthreads/worker.xml @@ -1,8 +1,7 @@ - + - - + Класс Worker Worker @@ -12,29 +11,29 @@
&reftitle.intro; - + Рабочие потоки имеют постоянный контекст, поэтому в большинстве случаев их следует использовать поверх потоков. - - + + Когда Worker запущен, будет выполнен метод run, но Thread не завершится, пока не будет выполнено одно из следующих условий: - + - Worker исчезнет из области видимости (не останется ни одной ссылки на него) + Worker исчезнет из области видимости (не останется ни одной ссылки на него) - программист вызовет функцию остановки + программист вызовет функцию остановки - скрипт завершит работу + скрипт завершит работу - + Это значит, что программист может переиспользовать контекст во время исполнения. Размещение объекта на стек объекта Worker приведёт к запуску метода run этого объекта. - +
@@ -71,10 +70,10 @@ &Methods; - + &InheritedMethods; - + diff --git a/reference/pthreads/worker/collect.xml b/reference/pthreads/worker/collect.xml index 1c575c131..38293c8be 100644 --- a/reference/pthreads/worker/collect.xml +++ b/reference/pthreads/worker/collect.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ public intWorker::collect Callablecollector - + Позволяет Worker собрать "мусорные" ссылки на задачи. Опционально можно задать пользовательский сборщик. - +
@@ -25,12 +25,12 @@ collector - + Сборщик типа Callable, который должен возвращать &true; или &false; в зависимости от того, можно ли собрать задачу. Случаи, когда вам может понадобиться собственный сборщик, крайне редки. - + @@ -38,10 +38,10 @@ &reftitle.returnvalues; - + Количество оставшихся задач в стеке Worker, которые будут собраны. - + diff --git a/reference/pthreads/worker/getstacked.xml b/reference/pthreads/worker/getstacked.xml index 8f5ac5819..45c240aa6 100644 --- a/reference/pthreads/worker/getstacked.xml +++ b/reference/pthreads/worker/getstacked.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intWorker::getStacked - + Возвращает количество задач, оставшихся в стеке. - + @@ -25,10 +25,10 @@ &reftitle.returnvalues; - + Возвращает количество задач, оставшихся в стеке и ожидающих запуска. - + diff --git a/reference/pthreads/worker/isshutdown.xml b/reference/pthreads/worker/isshutdown.xml index 000471848..c57efb6d1 100644 --- a/reference/pthreads/worker/isshutdown.xml +++ b/reference/pthreads/worker/isshutdown.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolWorker::isShutdown - + Определяет, остановлен Worker или нет. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + &true; если остановлен и &false;, если нет. - + diff --git a/reference/pthreads/worker/shutdown.xml b/reference/pthreads/worker/shutdown.xml index 23db27578..8ec7b9110 100644 --- a/reference/pthreads/worker/shutdown.xml +++ b/reference/pthreads/worker/shutdown.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public boolWorker::shutdown - + Остановить Worker после запуска всех задач со стека. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/pthreads/worker/stack.xml b/reference/pthreads/worker/stack.xml index e1b04a6d5..63b5c101a 100644 --- a/reference/pthreads/worker/stack.xml +++ b/reference/pthreads/worker/stack.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intWorker::stack Threadedwork - + Добавляет задачу на стек заданному Worker. - + @@ -24,10 +24,10 @@ work - + Объект типа Threaded, который будет запущен Worker. - + @@ -35,9 +35,9 @@ &reftitle.returnvalues; - + Новый размер стека. - + diff --git a/reference/pthreads/worker/unstack.xml b/reference/pthreads/worker/unstack.xml index d79130ea7..356d3475a 100644 --- a/reference/pthreads/worker/unstack.xml +++ b/reference/pthreads/worker/unstack.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ public intWorker::unstack - + Метод убирает первую задачу — самую старую — из стека. - + @@ -25,9 +25,9 @@ &reftitle.returnvalues; - + Новый размер стека. - +