Funktio array_rand

Funktio array_rand palauttaa satunnaisen avaimen taulukosta. Ensimmäisenä parametrina annetaan taulukko, ja toinen valinnainen parametri osoittaa, kuinka monta satunnaista avainta tulisi palauttaa. Jos sitä ei ole määritetty - palautetaan yksi avain, ja jos se on määritetty - määritetty määrä avaimia taulukon muodossa.

Syntaksi

phparray_rand(array $array, int $num = 1): int|string|array

Esimerkki

Tässä esimerkissä funktio palauttaa satunnaisen avaimen taulukosta:

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  echo array_rand($arr);
?>

Koodin suorituksen tulos:

php'c'

Esimerkki

Palautetaan satunnainen elementti taulukosta, tiedäen satunnaisen avaimen:

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  
  $key = array_rand($arr);
  echo $arr[$key];
?>

Koodin suorituksen tulos:

php3

Esimerkki

Asetetaan toinen parametri arvoon 3 - tässä tapauksessa funktio palauttaa taulukon jossa on 3 satunnaista avainta (3 avainta - koska toinen parametri on 3):

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  
  $keys = array_rand($arr, 3);
  var_dump($keys);
?>

Koodin suorituksen tulos:

php['a', 'b', 'e']

Katso myös

  • funktion shuffle,
    joka sekoittaa taulukon
  • funktion mt_rand,
    joka palauttaa satunnaisen numeron