Skip to content

Commit

Permalink
Sync some of the reference/random/ functions that were missing En-Rev
Browse files Browse the repository at this point in the history 
These were actually so simple that we can update them right away.
  • Loading branch information
@Sobak
Sobak committed May 10, 2024
1 parent 7b4f460 commit 33cb957
Show file tree
Hide file tree
Showing 4 changed files with 264 additions and 123 deletions.
14 changes: 10 additions & 4 deletions reference/random/functions/getrandmax.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,15 +8,21 @@
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>getrandmax</methodname>
<void/>
</methodsynopsis>
<methodsynopsis>
<type>int</type><methodname>getrandmax</methodname>
<void/>
</methodsynopsis>
<simpara>
Zwraca największą wartość, która może być zwrócona przez
<function>rand</function>.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Expand Down
69 changes: 44 additions & 25 deletions reference/random/functions/mt-getrandmax.xml
View file
Original file line number Diff line number Diff line change
@@ -1,29 +1,48 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: qrak Status: ready -->
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c174b16add554508aafdd40c5d3f2997099882b6 Maintainer: qrak Status: ready -->
<!-- $Revision$ -->
<refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mt_getrandmax</refname>
<refpurpose>Największa możliwa liczba losowa</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<methodsynopsis>
<type>int</type><methodname>mt_getrandmax</methodname>
<void/>
</methodsynopsis>
<simpara>
Zwraca największą liczbę losową, jaką może zwrócić funkcja
<function>mt_rand</function>.
</simpara>
<simpara>
Patrz także:
<function>mt_rand</function>,
<function>mt_srand</function> i
<function>getrandmax</function>.
</simpara>
</refsect1>
</refentry>
<refentry xml:id="function.mt-getrandmax" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mt_getrandmax</refname>
<refpurpose>Zwraca największą możliwą liczbę losową</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>mt_getrandmax</methodname>
<void/>
</methodsynopsis>
<simpara>
Zwraca największą wartość, która może być zwrócona przez
<function>mt_rand</function>.
</simpara>
</refsect1>

<refsect1 role="parameters">
&reftitle.parameters;
&no.function.parameters;
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Zwraca największą możliwą wartość losową zwrócona przez wywołanie
<function>mt_rand</function> bez argumentów, tj. największą wartość,
która może być użyta jako jej argument <parameter>max</parameter> bez
skalowania wyniku w górę (a zatem czynienia go mniej losowym).
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mt_rand</function></member>
<member><function>mt_srand</function></member>
<member><function>getrandmax</function></member>
</simplelist>
</para>
</refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
Expand Down
165 changes: 118 additions & 47 deletions reference/random/functions/mt-srand.xml
View file
Original file line number Diff line number Diff line change
@@ -1,52 +1,123 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: n/a Maintainer: qrak Status: ready -->
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.mt-srand" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mt_srand</refname>
<refpurpose>Inicjuje generator Mersenne Twister</refpurpose>
</refnamediv>
<refsect1>
<title>Opis</title>
<methodsynopsis>
<type>void</type><methodname>mt_srand</methodname>
<methodparam choice="opt"><type>int</type><parameter>ziarno</parameter></methodparam>
</methodsynopsis>
<para>
Inicjuje generator liczb losowych za pomocą ziarna
<parameter>ziarno</parameter>.
Począwszy od PHP 4.2.0, parametr <parameter>ziarno</parameter>
stał się opcjnalny i nie bierze udziału przy losowaniu wartości, jeśli go pominięto.
</para>
<para>
<example>
<title><function>mt_srand</function> przykład</title>
<programlisting role="php">
<![CDATA[
<?php
// naziarnij mikrosekundami
function make_seed()
{
list($usec,$sec) = explode(" ", microtime());
return ((float)$sec+(float)$usec) * 100000;
}
mt_srand(make_seed());
$randval = mt_rand();
?>
]]>
</programlisting>
</example>
</para>
&note.randomseed;
<simpara>
Patrz także:
<function>mt_rand</function>,
<function>mt_getrandmax</function> i
<function>srand</function>.
</simpara>
</refsect1>
</refentry>
<refentry xml:id="function.mt-srand" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mt_srand</refname>
<refpurpose>Ustawia ziarno dla generatora liczb losowych Mersenne Twister</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>void</type><methodname>mt_srand</methodname>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>seed</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>MT_RAND_MT19937</constant></initializer></methodparam>
</methodsynopsis>
<para>
Ustawia ziarno generatora liczb losowych
używając parametru <parameter>seed</parameter> lub losowej wartości,
jeśli parametr <parameter>seed</parameter> nie został podany.
</para>

&note.randomseed;
&caution.mt19937-tiny-seed;

</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>seed</parameter></term>
<listitem>
<para>
Wypełnia stan wartościami wygenerowanymi za pomocą liniowego generatora kongruencyjnego,
który został zainicjowany parametrem <parameter>seed</parameter> interpretowanym jako
liczba 32-bitowa bez znaku (+/-).
</para>
<para>
Jeśli parametr <parameter>seed</parameter> zostanie pominięty lub ustawiony na &null;, to zostanie użyta
losowa liczba 32-bitowa bez znaku.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
Użyj jednej z następujących stałych, aby określić implementację algorytmu, która powinna zostać użyta.
<simplelist>
<member>
<constant>MT_RAND_MT19937</constant>:
Poprawna implementacja algorytmu Mt19937, dostępna od PHP 7.1.0.
</member>
<member>
<constant>MT_RAND_PHP</constant>
Używa niepoprawnej implementacji algorytmu Mersenne Twiste, która była używana jako domyślna aż do PHP 7.1.0.
Ten tryb jest dostepny ze względu na kompatybilność wsteczną.
</member>
</simplelist>
</para>
&warn.deprecated.feature-8-3-0;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.void;
</para>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
Parametr <parameter>seed</parameter> akceptuje teraz null.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Funkcja <function>srand</function> <link linkend="migration71.incompatible.rand-srand-aliases">stała się</link> aliasem <function>mt_srand</function>.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
Funkcja <function>mt_rand</function> <link linkend="migration71.incompatible.fixes-to-mt_rand-algorithm">została zaktualizowana</link> tak, aby używać poprawnej wersji
algorytmu Mersenne. Aby wymusić poprzednie działanie, można wywołać <function>mt_srand</function> z drugim parametrem ustawionym na <constant>MT_RAND_PHP</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mt_rand</function></member>
<member><function>mt_getrandmax</function></member>
<member><function>srand</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
Loading

0 comments on commit 33cb957

Please sign in to comment.