php/archived-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update Random* to En (#1154)

Browse Source 
* Update random.brokenrandomengineerror.xml

* Update random.cryptosafeengine.xml

* Update random.engine.mt19937.xml

* Update random.engine.pcgoneseq128xslrr64.xml

* Update random.brokenrandomengineerror.xml

* Update random.cryptosafeengine.xml

* Update random.engine.secure.xml

* Update random.engine.xml

* Update random.engine.xoshiro256starstar.xml

* Update random.randomerror.xml

* Update random.randomerror.xml

* Update random.randomexception.xml

* Update random.randomizer.xml
This commit is contained in:
Mikhail Alferov
2026-03-01 02:09:31 +03:00
committed by GitHub
parent 9ef332d224
commit 0727946ba8
10 changed files with 278 additions and 243 deletions
Download Patch File Download Diff File Expand all files Collapse all files

56
reference/random/random.brokenrandomengineerror.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-brokenrandomengineerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Ошибка Random\BrokenRandomEngineError</title>
@@ -11,40 +11,44 @@
<section xml:id="random-brokenrandomengineerror.intro">
&reftitle.intro;
<para>
Ошибка указывает, что движок <classname>Random\Engine</classname> неисправен,
например из-за чрезмерной предвзятости и неравномерного распределения результатов.
Ошибка указывает на неисправность движка интерфейса <classname>Random\Engine</classname>,
например из-за критического статистического смещения и неравномерного распределения результатов.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-brokenrandomengineerror.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooexception>
<exceptionname>Random\BrokenRandomEngineError</exceptionname>
</ooexception>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random</package>
<ooclass>
<modifier>extends</modifier>
<classname>Random\RandomError</classname>
</ooclass>
<classsynopsis class="class">
<ooexception>
<exceptionname>BrokenRandomEngineError</exceptionname>
</ooexception>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<ooclass>
<modifier>extends</modifier>
<classname>Random\RandomError</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

40
reference/random/random.cryptosafeengine.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-cryptosafeengine" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Интерфейс Random\CryptoSafeEngine</title>
@@ -11,31 +11,35 @@
<section xml:id="random-cryptosafeengine.intro">
&reftitle.intro;
<para>
Интерфейс, указывающий, что тип <type>Random\Engine</type> возвращает криптографически безопасную случайную последовательность.
Маркерный интерфейс, который указывает, что движок интерфейса <type>Random\Engine</type> возвращает криптографически безопасную случайную последовательность.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-cryptosafeengine.synopsis">
&reftitle.interfacesynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="interface">
<oointerface>
<interfacename>Random\CryptoSafeEngine</interfacename>
</oointerface>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random</package>
<oointerface>
<modifier>extends</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsis class="interface">
<oointerface>
<interfacename>CryptoSafeEngine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<oointerface>
<modifier>extends</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

48
reference/random/random.engine.mt19937.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-engine-mt19937" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Random\Engine\Mt19937</title>
@@ -11,35 +11,39 @@
<section xml:id="random-engine-mt19937.intro">
&reftitle.intro;
<para>
Реализует алгоритм <link xlink:href="&url.random.mersenne-twister;">Mt19937</link> ("Mersenne Twister").
Класс реализует алгоритм <link xlink:href="&url.random.mersenne-twister;">Mt19937</link> — «Вихрь Мерсе́нна».
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-engine-mt19937.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Random\Engine\Mt19937</classname>
</ooclass>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random\Engine</package>
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Mt19937</classname>
</ooclass>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Engine\\Mt19937'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\Mt19937'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Engine\\Mt19937'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-mt19937')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\Mt19937'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

50
reference/random/random.engine.pcgoneseq128xslrr64.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-engine-pcgoneseq128xslrr64" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Random\Engine\PcgOneseq128XslRr64</title>
@@ -11,36 +11,40 @@
<section xml:id="random-engine-pcgoneseq128xslrr64.intro">
&reftitle.intro;
<para>
Реализует <link xlink:href="&url.random.pcg;">перестановочный конгруэнтный генератор (PCG)</link> со 128 битами состояния,
преобразованиями XSL и RR и 64 битами на выходе.
Класс реализует PCG (англ. Permuted Congruential Generator) — <link xlink:href="&url.random.pcg;">перестановочный конгруэнтный генератор</link>
со 128-битным состоянием, преобразованиями выходных данных XSL и RR и 64-битным выходом.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-engine-pcgoneseq128xslrr64.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Random\Engine\PcgOneseq128XslRr64</classname>
</ooclass>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random\Engine</package>
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>PcgOneseq128XslRr64</classname>
</ooclass>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Engine\\PcgOneseq128XslRr64'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\PcgOneseq128XslRr64'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Engine\\PcgOneseq128XslRr64'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-pcgoneseq128xslrr64')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\PcgOneseq128XslRr64'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

50
reference/random/random.engine.secure.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-engine-secure" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Random\Engine\Secure</title>
@@ -11,40 +11,44 @@
<section xml:id="random-engine-secure.intro">
&reftitle.intro;
<para>
Создаёт криптографически безопасную случайную последовательность, используя <acronym>CSPRNG</acronym> операционной системы.
Класс создаёт криптографически безопасную случайную последовательность средством <acronym>CSPRNG</acronym> операционной системы.
</para>
<para>
Случайная последовательность, создаваемая <classname>Random\Engine</classname>, подходит для всех приложений,
включая создание долгосрочных секретов, таких как ключи шифрования.
Этот движок интерфейса <classname>Random\Engine</classname> генерирует случайные последовательности, которые применяют для шифрования и защиты данных:
как ключи шифрования, токены доступа, соль для хеширования паролей и другие долгосрочные или временные криптографические параметры.
</para>
<para>
Механизм <classname>Random\Engine\Secure</classname> является рекомендуемым безопасным выбором по умолчанию,
если только приложение не требует воспроизводимых последовательностей или очень высокой производительности.
Механизм <classname>Random\Engine\Secure</classname> — рекомендуемый безопасный выбор по умолчанию,
если только приложение не требует воспроизводимых последовательностей или повышенной производительности.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-engine-secure.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Random\Engine\Secure</classname>
</ooclass>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random\Engine</package>
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\CryptoSafeEngine</interfacename>
</oointerface>
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Secure</classname>
</ooclass>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-secure')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\Secure'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\CryptoSafeEngine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-secure')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\Secure'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

56
reference/random/random.engine.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9eb4a46bba05da229be4c8f7a3cb64702e1a2f95 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-engine" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Интерфейс Random\Engine</title>
@@ -11,43 +11,43 @@
<section xml:id="random-engine.intro">
&reftitle.intro;
<para>
Интерфейс <classname>Random\Engine</classname> предлагает низкоуровневый источник
случайной последовательности и возвращает случайные байты, которые потребляют
высокоуровневые API, чтобы выполнять свои операции. Интерфейс
<classname>Random\Engine</classname> разрешает менять местами алгоритм
генерации случайной последовательности, поскольку каждый алгоритм идёт на компромиссы,
чтобы соответствовать конкретным задачам. Одни алгоритмы очень быстры,
но генерируют случайную последовательность более низкого качества. Тогда как другие алгоритмы
медленнее, но генерируют случайную последовательность лучше,
вплоть до криптографически безопасной случайной последовательности,
которую даёт движок <classname>Random\Engine\Secure</classname>.
Интерфейс <classname>Random\Engine</classname> определяет низкоуровневый источник
случайных последовательностей. Реализации интерфейса возвращают случайные байты,
которые требуются для выполнения операций высокоуровневыми API.
Интерфейс <classname>Random\Engine</classname> поддерживает переключение алгоритмов
генерации случайной последовательности для адаптации источника случайных последовательностей
под конкретные задачи: от сверхбыстрых алгоритмов с посредственной статистикой до криптографически стойких механизмов
наподобие движка <classname>Random\Engine\Secure</classname>.
</para>
<para>
PHP предлагает ряд готовых движков <classname>Random\Engine</classname>,
чтобы удовлетворить разным задачам. Движок <classname>Random\Engine\Secure</classname>,
который поддерживается криптографически стойким генератором псевдослучайных чисел <acronym>CSPRNG</acronym>,
рекомендуют как безопасный выбор по умолчанию, если только приложение не требует
воспроизводимых последовательностей или повышенной производительности.
В PHP предусмотрели ряд готовых генераторов на базе интерфейса <classname>Random\Engine</classname>,
каждый под конкретный сценарий. Движок <classname>Random\Engine\Secure</classname>
на базе <acronym>CSPRNG</acronym> — безопасный выбор по умолчанию, если только приложению
не требуются воспроизводимые последовательности или повышенная производительность.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-engine.synopsis">
&reftitle.interfacesynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="interface">
<oointerface>
<interfacename>Random\Engine</interfacename>
</oointerface>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random</package>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<classsynopsis class="interface">
<oointerface>
<interfacename>Engine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

48
reference/random/random.engine.xoshiro256starstar.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-engine-xoshiro256starstar" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Random\Engine\Xoshiro256StarStar</title>
@@ -11,35 +11,39 @@
<section xml:id="random-engine-xoshiro256starstar.intro">
&reftitle.intro;
<para>
Реализует алгоритм <link xlink:href="&url.random.xoshiro;">xoshiro256**</link>.
Класс реализует алгоритм <link xlink:href="&url.random.xoshiro;">xoshiro256**</link>.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-engine-xoshiro256starstar.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Random\Engine\Xoshiro256StarStar</classname>
</ooclass>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random\Engine</package>
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Xoshiro256StarStar</classname>
</ooclass>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Engine\\Xoshiro256StarStar'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\Xoshiro256StarStar'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<oointerface>
<modifier>implements</modifier>
<interfacename>Random\Engine</interfacename>
</oointerface>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Engine\\Xoshiro256StarStar'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-engine-xoshiro256starstar')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Engine\\Xoshiro256StarStar'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

56
reference/random/random.randomerror.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-randomerror" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Ошибка Random\RandomError</title>
@@ -11,40 +11,44 @@
<section xml:id="random-randomerror.intro">
&reftitle.intro;
<para>
Базовый класс в иерархии классов <type>Error</type> для ошибок,
которые возникают при генерации или обработке случайных данных.
Подтип класса <type>Error</type> и базовый класс ошибок,
которые возникают при генерации или обработке случайных последовательностей.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-randomerror.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooexception>
<exceptionname>Random\RandomError</exceptionname>
</ooexception>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random</package>
<ooclass>
<modifier>extends</modifier>
<classname>Error</classname>
</ooclass>
<classsynopsis class="class">
<ooexception>
<exceptionname>RandomError</exceptionname>
</ooexception>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<ooclass>
<modifier>extends</modifier>
<classname>Error</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.error')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Error'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

54
reference/random/random.randomexception.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-randomexception" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Random\RandomException</title>
@@ -11,39 +11,43 @@
<section xml:id="random-randomexception.intro">
&reftitle.intro;
<para>
Базовый класс для исключений <type>Exception</type>, возникающих при генерации или использовании случайной последовательности.
Подтип класса <type>Exception</type> и базовый класс исключений, которые возникают при генерации или обработке случайных последовательностей.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-randomexception.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooexception>
<exceptionname>Random\RandomException</exceptionname>
</ooexception>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random</package>
<ooclass>
<modifier>extends</modifier>
<classname>Exception</classname>
</ooclass>
<classsynopsis class="class">
<ooexception>
<exceptionname>RandomException</exceptionname>
</ooexception>
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<ooclass>
<modifier>extends</modifier>
<classname>Exception</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<classsynopsisinfo role="comment">&InheritedProperties;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Properties;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Exception'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.exception')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Exception'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>

63
reference/random/random.randomizer.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: sergey Status: ready -->
<!-- EN-Revision: c8e3b2ccadcf79d3c9d53c532ca02572b02f741d Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.random-randomizer" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Random\Randomizer</title>
@@ -11,44 +11,48 @@
<section xml:id="random-randomizer.intro">
&reftitle.intro;
<para>
Класс открывает высокоуровневый API-интерфейс к случайным последовательностям,
которые генерируют объекты интерфейса <classname>Random\Engine</classname>.
Класс — высокоуровневый интерфейс для операций со случайными данными,
которые генерируют механизмы на базе интерфейса <classname>Random\Engine</classname>.
</para>
</section>
<!-- }}} -->
<!-- }}} -->
<section xml:id="random-randomizer.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Random\Randomizer</classname>
</ooclass>
<!-- {{{ Synopsis -->
<packagesynopsis>
<package>Random</package>
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>Random\Engine</type>
<varname linkend="random-randomizer.props.engine">engine</varname>
</fieldsynopsis>
<classsynopsis class="class">
<ooclass>
<modifier>final</modifier>
<classname>Randomizer</classname>
</ooclass>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Randomizer'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Randomizer'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->
<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>readonly</modifier>
<type>Random\Engine</type>
<varname linkend="random-randomizer.props.engine">engine</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='Random\\Randomizer'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.random-randomizer')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Random\\Randomizer'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
</packagesynopsis>
<!-- }}} -->
</section>
<!-- {{{ Random\Randomizer properties -->
<!-- {{{ Random\Randomizer properties -->
<section xml:id="random-randomizer.props">
&reftitle.properties;
<variablelist>
@@ -56,14 +60,13 @@
<term><varname>engine</varname></term>
<listitem>
<para>
Низкоуровневый источник случайной последовательности
для методов класса <type>Random\Randomizer</type>.
Низкоуровневый источник случайных последовательностей для методов класса <type>Random\Randomizer</type>.
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
<!-- }}} -->
<!-- }}} -->
</partintro>