배열 array_rand

(PHP 4, PHP 5, PHP 7, PHP 8)

array_rand — 배열에서 하나 이상의 임의 키 선택


설명

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

배열에서 하나 이상의 임의 항목을 선택하고 임의 항목의 키를 반환합니다. 암호화 목적에 적합하지 않은 의사 난수 생성기를 사용합니다.


매개변수

array
입력 배열입니다.
num
선택해야 하는 항목 수를 지정합니다.

반환 값

하나의 항목만 선택할 때 array_rand()는 임의의 항목에 대한 키를 반환합니다. 그렇지 않으면 임의 항목에 대한 키 배열이 반환됩니다. 이것은 임의의 값뿐만 아니라 배열에서 임의의 키를 선택할 수 있도록 수행됩니다.

여러 키가 반환되면 원래 배열에 있던 순서대로 반환됩니다. 배열에 있는 것보다 더 많은 요소를 선택하려고 하면 E_WARNING 수준 오류가 발생하고 NULL이 반환됩니다.


변경 로그

버전 설명
7.1.0 내부 무작위 알고리즘이 libc rand 함수 대신 » Mersenne Twister 난수 생성기를 사용하도록 변경되었습니다.

Examples

예제 #1 array_rand() 예제

                  
<?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";
?>
                  
                

기타