Random\Randomizer::shuffleBytes

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleBytes — Devuelve una permutación por octeto de una cadena de caracteres

Descripción

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

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 subyacente.

Ejemplos

Ejemplo #1 Ejemplo de Random\Randomizer::shuffleBytes()

<?php
$r = new \Random\Randomizer();

// Mezclar los octetos en una cadena:
echo "«", $r->shuffleBytes("PHP is great!"), "»\n";
?>

Resultado del ejemplo anterior es similar a:

« ga rHs!PPiet»

Ejemplo #2 Mezcla por octeto de caracteres Unicode

<?php
$r = new \Random\Randomizer();

$unicode = "🍎, 🥝, 🍌, 🍑, 🍇";
$shuffled = $r->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";
?>

Resultado del ejemplo anterior es similar a:

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