Random\Randomizer::pickArrayKeys
(PHP 8 >= 8.2.0)
Random\Randomizer::pickArrayKeys — Вибирає випадкові ключі масиву
Опис
public Random\Randomizer::pickArrayKeys(array $array, int $num): array
Поступово вибирає num окремих ключів масиву вхідного масиву array
Кожен ключ вхідного масиву array з рівною ймовірністю буде повернено.
Застереження
Вибір ключів масиву залежить від внутрішньої структури вхідного масиву array. Ключі масиву, що повертається, можуть бути різними для двох однакових вхідних масивів і двох об'єктів Random\Engine з однаковим станом, залежно від того, як було створено вхідні масиви.
Список параметрів
array
Масив, ключі масиву якого вибираються.
num
Кількість ключів масиву, що повертаються; має бути між і кількістю елементів у параметрі array
Значення, що повертаються
Массив (array), содержащийnum окремих ключів масиву array
Повертається масив (array) буде списком (array_is_list()). Це буде підмножина масивів (array), що повертаються функцією array_keys()
Помилки
- Якщо параметр
numменьше або більше кількості елементів у параметріarray, буде викинуто виняток ValueError - Будь-які Throwable, що викидаються методомRandom\Engine::generate()базового
Random\Randomizer::$engine
Приклади
Приклад #1 Приклад використання Random\Randomizer::pickArrayKeys()****
Висновок наведеного прикладу буде схожим на:
Ключи: yellow, purple
Ключи: red, green, yellow
Приклад #2 Вибір випадкових значень
Висновок наведеного прикладу буде схожим на:
Значения: 🍎, 🍇
Дивіться також
- array_keys() - Повертає все або деяке підмножина ключів масиву