From 11d579933869cc74d58f844227c0fc2a299391a5 Mon Sep 17 00:00:00 2001
From: Javier Eguiluz <javier.eguiluz@gmail.com>
Date: Tue, 5 May 2020 10:50:19 +0200
Subject: [PATCH] [String] Set characters to use in ByteString::fromRandom()

---
 components/string.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/components/string.rst b/components/string.rst
index f98c33c51b8..24d83df2b88 100644
--- a/components/string.rst
+++ b/components/string.rst
@@ -133,11 +133,19 @@ There are also some specialized constructors::
 
     // ByteString can create a random string of the given length
     $foo = ByteString::fromRandom(12);
+    // by default, random strings use A-Za-z0-9 characters; you can restrict
+    // the characters to use with the second optional argument
+    $foo = ByteString::fromRandom(6, 'AEIOU0123456789');
+    $foo = ByteString::fromRandom(10, 'qwertyuiop');
 
     // CodePointString and UnicodeString can create a string from code points
     $foo = UnicodeString::fromCodePoints(0x928, 0x92E, 0x938, 0x94D, 0x924, 0x947);
     // equivalent to: $foo = new UnicodeString('नमस्ते');
 
+.. versionadded:: 5.1
+
+    The second argument of ``ByteString::fromRandom()`` was introduced in Symfony 5.1.
+
 Methods to Transform String Objects
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~