ARRAY_RAND |
Tableau : Aléatoire |
| PHP 4.0+ |
Syntaxe
|
function array_rand($input);
|
|
function array_rand($input,$num_req);
|
Paramètres
| Nom |
Description |
| $input |
Ce paramètre permet d'indiquer les tableaux à exploiter. |
| $num_req |
Ce paramètre permet d'indiquer le nombre de valeurs à retourner. |
Retour
| Valeur |
Description |
| variante |
Cette valeur permet d'indiquer la valeur demandé. |
| tableau |
Ces valeurs permettent d'indiquer le nombre de valeurs demandés. |
Description
Cette fonction permet de retourner une ou plusieurs valeurs sélectionner au hasard dans l'une des cellules du tableau.
Remarques
- Sélection aléatoire d'un ou plusieurs éléments : La fonction array_rand() permet de sélectionner un ou plusieurs éléments de manière aléatoire dans un
tableau. Par défaut, elle retourne une clef aléatoire du tableau, mais elle peut aussi être utilisée pour obtenir plusieurs clefs aléatoires en spécifiant un deuxième paramètre.
- Retourne la clef de l'élément sélectionné : Contrairement à d'autres fonctions comme array_rand() retournant directement la valeur de l'élément sélectionné,
cette fonction retourne la clef de l'élément aléatoire. Cela permet de retrouver directement la position de l'élément dans le tableau sans avoir à rechercher la valeur.
- Gestion des tableaux associatifs et indexés : array_rand() fonctionne de manière similaire, que le tableau soit associatif ou indexé. Dans les tableaux
associatifs, elle retourne une clef associée à l'élément, et dans les tableaux indexés, elle retourne un indice numérique.
- Sélection de plusieurs éléments : Si vous souhaitez sélectionner plusieurs éléments, vous pouvez passer un second paramètre à la fonction pour indiquer le nombre
d'éléments à retourner. Dans ce cas, un tableau de clefs aléatoires est retourné, ce qui permet de récupérer plusieurs éléments du tableau.
- Comportement avec un tableau vide : Si array_rand() est utilisée sur un tableau vide, la fonction retourne une erreur. Il est donc important de vérifier
que le tableau contient des éléments avant d'utiliser la fonction pour éviter des erreurs inattendues.
- Index non répliqués : Si vous demandez plusieurs clés aléatoires, les éléments retournés par array_rand() seront uniques, c'est-à-dire que la même clef ne
sera pas sélectionnée plus d'une fois. Cela garantit qu'il n'y a pas de répétition dans les éléments choisis.
- Utilisation dans des jeux de hasard ou des tirages au sort : array_rand() est particulièrement utile pour des applications nécessitant un tirage au sort ou une
sélection aléatoire d'éléments, comme dans des jeux, des simulations ou des systèmes de recommandations aléatoires.
- Limitations avec des clefs numériques non séquentielles : Lorsque des tableaux avec des clefs numériques non séquentielles (par exemple, 0, 5, 10) sont
utilisés, array_rand() peut retourner une clef ne correspondant pas nécessairement à un index consécutif. Cela peut être utile dans des cas où l'indexation n'est pas
continue, mais peut nécessiter un traitement supplémentaire si les indices doivent être réorganisés.
Références
PHP 4 - Guide du développeur, Edition First Interactive, Blake Schwendiman, 2002, ISBN: 2-84427-283-5, page 363
Dernière mise à jour : Dimanche, le 22 mars 2015
