svn: /phpdoc/ru/trunk/reference/array/functions/ array-rand.xml

From: Date: Sun, 30 Jan 2011 09:04:21 +0000
Subject: svn: /phpdoc/ru/trunk/reference/array/functions/ array-rand.xml
Groups: php.doc.ru 
Request: Send a blank email to doc-ru+get-1303@lists.php.net to get a copy of this message
shein Sun, 30 Jan 2011 09:04:21 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=307848 Log: Updated translation. Changed paths: U phpdoc/ru/trunk/reference/array/functions/array-rand.xml Modified: phpdoc/ru/trunk/reference/array/functions/array-rand.xml =================================================================== --- phpdoc/ru/trunk/reference/array/functions/array-rand.xml 2011-01-30 08:55:40 UTC (rev 307847) +++ phpdoc/ru/trunk/reference/array/functions/array-rand.xml 2011-01-30 09:04:21 UTC (rev 307848) @@ -1,58 +1,111 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: n/a Maintainer: sveta Status: ready --> +<!-- EN-Revision: 304976 Maintainer: shein Status: ready --> +<!-- Reviewed: no --> <!-- $Revision$ --> -<!-- splitted from ./en/functions/array.xml, last change in rev 1.13 --> - <refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook"> - <refnamediv> - <refname>array_rand</refname> - <refpurpose> - Выбрать одно или несколько случайных значений из массива - </refpurpose> - </refnamediv> - <refsect1> - <title>Описание</title> - <methodsynopsis> - <type>mixed</type><methodname>array_rand</methodname> - <methodparam><type>array</type><parameter>input</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>num_req</parameter></methodparam> - </methodsynopsis> - <para> - Использование <function>array_rand</function> предпочтительно, если вам нужно - выбрать одно или несколько случайных значений из массива. Эта функция в качестве - параметров берёт массив <parameter>input</parameter> и дополнительный аргумент - <parameter>num_req</parameter>, который определяет количество значений, которое - вы хотите выбрать - если не определён, то 1. - </para> - <para> - Если вы выбираете только одно значение, функция <function>array_rand</function> - возвращает ключ, соответствующий этому значению. В обратном случае, она возвращает - массив ключей, соответствующих случайным значениям. Это означает, что вы можете выбрать - из массива как случайные значения, так и случайные ключи. - </para> - - &note.randomseed; - - <para> - <example> - <title>Пример использования <function>array_rand</function></title> - <programlisting role="php"> +<refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook"> + <refnamediv> + <refname>array_rand</refname> + <refpurpose>Выбирает одно или несколько случайных значений из массива</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>mixed</type><methodname>array_rand</methodname> + <methodparam><type>array</type><parameter>input</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>num_req</parameter><initializer>1</initializer></methodparam> + </methodsynopsis> + <para> + Выбирает одно или несколько случайных значений из массива. Возвращает + ключ (или ключи) данных случайных элементов. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>input</parameter></term> + <listitem> + <para> + Входной массив. + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>num_req</parameter></term> + <listitem> + <para> + Определяет количество выбираемых элементов. Попытка выбрать + больше элементов, чем есть в массиве, сгенерирует ошибку + уровня <constant>E_WARNING</constant>. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Если вы выбираете только одно значение, функция <function>array_rand</function> + возвращает ключ, соответствующий этому значению. В обратном случае, она возвращает + массив ключей, соответствующих случайным значениям. Это сделано + так образом, чтобы дать возможность выбрать из массива как + случайные значения, так и случайные ключи. + </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>5.2.10</entry> + <entry> + Возвращаемый массив ключей больше не возвращается в случайном + порядке. + </entry> + </row> + &changelog.randomseed; + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Пример использования <function>array_rand</function></title> + <programlisting role="php"> <![CDATA[ <?php -srand((float) microtime() * 10000000); $input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank"); $rand_keys = array_rand($input, 2); echo $input[$rand_keys[0]] . "\n"; echo $input[$rand_keys[1]] . "\n"; ?> ]]> - </programlisting> - </example> - </para> - <para> - См. также <function>shuffle</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>shuffle</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: @@ -65,7 +118,7 @@ sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil -sgml-default-dtd-file:"../~/.phpdoc/manual.ced" +sgml-default-dtd-file:"~/.phpdoc/manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil

« previous php.doc.ru (#1303) next »