array-rand.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4a1dedc24b1e085f298ab1d5dadefe306373691b 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. Boş olamaz.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>istek_sayısı</parameter></term>
     <listitem>
      <para>
       Kaç tane rasgele eleman döndürüleceği belirtilir. Sıfırdan büyük ve
       <parameter>dizi</parameter> uzunluğundan küçük veya ona eşit olmalıdır.
      </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.
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   <parameter>dizi</parameter> boşsa veya <parameter>istek_sayısı</parameter>
   aralık dışındaysa bir <classname>ValueError</classname> 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>8.0.0</entry>
       <entry>
        <parameter>istek_sayısı</parameter> aralık dışındaysa artık bir
        <classname>ValueError</classname> oluşuyor. Evvelce bir
        <constant>E_WARNING</constant> yayımlanır ve işlev &null; döndürürdü.
       </entry>
      </row>
      <row>
       <entry>8.0.0</entry>
       <entry>
        <parameter>dizi</parameter> boşsa artık bir
        <classname>ValueError</classname> oluşuyor. Evvelce bir
        <constant>E_WARNING</constant> yayımlanır ve işlev &null; döndürürdü.
       </entry>
      </row>
      <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
-->