Random\Randomizer::shuffleBytes

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 por octeto de una cadena de caracteres

Descripción#

public Random\Randomizer::shuffleBytes(string $bytes): string
```php

Devuelve una permutación seleccionada uniformemente de los `bytes` de entrada.

Cada permutación posible de los `bytes` de entrada tiene la misma probabilidad de ser devuelta.

## Parámetros

`bytes`  
La `string` cuyos octetos se mezclan.

La `string` de entrada no será modificada.

## Valores devueltos

Una permutación de los octetos de `bytes`.

## 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::shuffleBytes`

shuffleBytes("PHP is great!"), "»\n"; ?>

Resultado del ejemplo anterior es similar a:

    « ga rHs!PPiet»

Mezcla por octeto de caracteres Unicode

shuffleBytes( $unicode ); // La mezcla por octeto de caracteres no-ASCII los destruye, // lo que resulta en secuencias inválidas (indicadas por el carácter // de reemplazo Unicode) o incluso la aparición de caracteres // completamente diferentes en la salida. echo "Original: ", $unicode, "\n"; echo "Shuffled: «", $shuffled, "»\n"; echo "Shuffled Bytes: ", bin2hex($shuffled), "\n"; ?>

```php

Resultado del ejemplo anterior es similar a:

Original: 🍎, 🥝, 🍌, 🍑, 🍇
Shuffled: «� ��,�����🍟,� �� �, �,��»
Shuffled Bytes: 87208e912c8d9fa5f0f0f09f8d9f2cf09f208c9d20f02c209f2c8d8d