array-rand.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fc1e94a9c2e271c7cefd86f28a1cb5bc30a52664 Maintainer: nilgun Status: ready -->
<refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook"
          xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>array_rand</refname>
  <refpurpose>Bir diziden belli sayıda rasgele anahtar döndürür</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>int</type><type>string</type><type>array</type></type><methodname>array_rand</methodname>
   <methodparam><type>array</type><parameter>dizi</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>istek_sayısı</parameter><initializer>1</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>array_rand</function> işlevi bir diziden belli sayıda rasgele
   eleman seçer ve bunların anahtarlarını döndürür.
  </para>
  &caution.cryptographically-insecure;
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>dizi</parameter></term>
     <listitem>
      <para>
       İşleme sokulacak dizi.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>istek_sayısı</parameter></term>
     <listitem>
      <para>
       Kaç tane rasgele eleman döndürüleceği belirtilir.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Sadece bir girdi alınmak istenirse <function>array_rand</function> işlevi
   diziden rasgele bir anahtarla döner. Aksi takdirde, rasgele elemanların
   anahtarlarını içeren bir dizi döndürür. Böylece, diziden rasgele anahtarlar
   değerleriyle birlikte bir dizi olarak çekilmiş olur. Birden fazla anahtar
   döndürülüyorsa, bunlar dizideki yerlerine uygun sırada çekilir. Dizideki öğe
   sayısından daha fazla öğe çekilmek istenirse <constant>E_WARNING</constant>
   seviyesinde bir hata oluşur.
  </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>7.1.10</entry>
       <entry>
        Dahili rasgelelik algoritması <link
        linkend="migration71.incompatible.rand-srand-aliases">değiştirildi</link>.
        Libc rand işlevi yerine artık <link xlink:href="&url.mersenne;">Mersenne
        Twister</link> Rasgele Sayı Üreteci kullanılıyor.
       </entry>
      </row>
      &changelog.randomseed;
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>array_rand</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
$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>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>Random\Randomizer::pickArrayKeys</function></member>
    <member><function>Random\Randomizer::shuffleArray</function></member>
   </simplelist>
  </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
-->