1
0
mirror of https://github.com/php/doc-ru.git synced 2026-04-30 02:33:22 +02:00
Files
archived-doc-ru/reference/gmp/functions/gmp-random.xml
T
2023-03-30 21:29:36 +03:00

108 lines
3.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7916b9cb9812aca7d8f241f96976af2d650de911 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.gmp-random">
<refnamediv>
<refname>gmp_random</refname>
<refpurpose>Случайное число</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-7-2-0.removed-8-0-0;
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>GMP</type><methodname>gmp_random</methodname>
<methodparam choice="opt"><type>int</type><parameter>limiter</parameter><initializer>20</initializer></methodparam>
</methodsynopsis>
<para>
Генерирует случайное число. Число будет лежать в пределах от нуля до (2 ** n) - 1,
где n - это число, представляющее из себя произведение числа
<parameter>limiter</parameter> и количества бит в лимбе (limb).
Если число <parameter>limiter</parameter> отрицательное, то будет возвращён
отрицательный результат.
</para>
<para>
Лимб (дословно конечность) - внутренний GMP механизм. Технически это часть
числа, помещающаяся в одно машинное слово. Количество бит в нем может
различаться в разных системах. В основном это либо 32, либо 64, но это не
гарантируется.
</para>
&caution.cryptographically-insecure;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>limiter</parameter></term>
<listitem>
<para>
Ограничитель.
</para>
&gmp.parameter;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Случайное GMP число.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>gmp_random</function></title>
<programlisting role="php">
<![CDATA[
<?php
$rand1 = gmp_random(1); // случайное число от 0 до 1 * бит на лимб
$rand2 = gmp_random(2); // случайное число от 0 до 2 * бит на лимб
echo gmp_strval($rand1) . "\n";
echo gmp_strval($rand2) . "\n";
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
1915834968
8642564075890328087
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->