Random\Randomizer::shuffleArray

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#

Devuelve una permutación de un array

Descripción#

public Random\Randomizer::shuffleArray(array $array): array
```php

Devuelve una permutación seleccionada uniformemente del `array` de entrada.

Cada permutación posible del `array` de entrada tiene la misma probabilidad de ser devuelta.

## Parámetros

`array`  
El `array` cuyos valores se mezclan.

El `array` de entrada no será modificado.

## Valores devueltos

Una permutación de los valores de `array`.

Las claves del `array` de entrada no serán preservadas; el `array` devuelto será una lista (`array_is_list`).

## Errores/Excepciones

- Cualquier `Throwable` lanzado por el método Random\Engine::generate del [`Random\Randomizer::$engine`](#random-randomizer.props.engine) subyacente.

## Ejemplos

Ejemplo de `Random\Randomizer::shuffleArray`

'🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ]; // Mezclar el array: echo "Ensalada: ", implode(', ', $r->shuffleArray($fruits)), "\n"; // Mezclar nuevamente: echo "Otra Ensalada: ", implode(', ', $r->shuffleArray($fruits)), "\n"; ?>

```php

Resultado del ejemplo anterior es similar a:

Ensalada: 🍎, 🥝, 🍇, 🍌, 🍑
Otra Ensalada: 🍑, 🍇, 🥝, 🍎, 🍌