الفرق بين المراجعتين لصفحة: «PHP/str shuffle»

من موسوعة حسوب
< PHP
أضفت المحتوى
 
لا ملخص تعديل
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE:الدالة <code>str_shuffle()</code>‎ في PHP}}</noinclude>
= الدالة str_shuffle()‎ في PHP =
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
(PHP 4 >= 4.3.0, PHP 5, PHP 7)


تخلط الدالة str_shuffle()‎ المحارف في السلسلة النصية عشوائيًا.
تخلط الدالة <code>str_shuffle()‎</code> المحارف في السلسلة النصية عشوائيًا.


== الوصف ==
== الوصف ==
<syntaxhighlight lang="php">
<syntaxhighlight lang="php">
string str_shuffle ( string $str )
string str_shuffle ( string $str )
</syntaxhighlight>تُغَيِّرُ الدالة str_shuffle()‎ السلسلة النصية. يُنشَأ الخليط من كل ما هو ممكن.
</syntaxhighlight>تُغَيِّرُ الدالة <code>str_shuffle()‎</code> السلسلة النصية. يُنشَأ الخليط من كل ما هو ممكن.


تحذير: هذه الدالة لا تولد قيم آمنة مشفرة، يجب ألا تستخدم لأغراض التشفير. إذا كنت بحاجة إلى قيمة آمنة مشفرة، ففكر في استخدام الدالة random_int()‎ أو الدالة random_bytes()‎ أو الدالة openssl_random_pseudo_bytes()‎ بدلاً من ذلك.
تحذير: هذه الدالة لا تولد قيم آمنة مشفرة، يجب ألا تستخدم لأغراض التشفير. إذا كنت بحاجة إلى قيمة آمنة مشفرة، ففكر في استخدام الدالة <code>[[PHP/random int|random_int()‎]]</code> أو الدالة <code>[[PHP/random bytes|random_bytes()‎]]</code> أو الدالة <code>[[PHP/openssl random pseudo bytes|openssl_random_pseudo_bytes()‎]]</code> بدلاً من ذلك.


== المعاملات ==
== المعاملات ==


=== str ===
=== <code>str</code> ===
السلسلة المدخلة.
السلسلة المدخلة.


=== القيم المعادة ===
== القيم المعادة ==
تعيد الدالة str_shuffle()‎ سلسلة نصية معدلَّة.
تعيد الدالة <code>str_shuffle()‎</code> سلسلة نصية معدلَّة.


== التغييرات ==
== التغييرات ==
{| class="wikitable"
{| class="wikitable"
|الإصدار
!الإصدار
|الوصف
!الوصف
|-
|-
|7.1.0
|7.1.0
|غُيِّرت الخوارزمية العشوائية الداخلية لاستخدام  "مولد رقم Mersenne Twister العشوائي" بدلاً من الدالة rand.
|غُيِّرت الخوارزمية العشوائية الداخلية لاستخدام  "مولد رقم Mersenne Twister العشوائي" بدلاً من الدالة <code>[[PHP/rand|rand]]</code>.
|}
|}


== أمثلة ==
== أمثلة ==
المثال 1: مثال على الدالة str_shuffle()‎<syntaxhighlight lang="php">
المثال 1: مثال على الدالة <code>str_shuffle()‎</code><syntaxhighlight lang="php">
<?php
<?php
$str = 'abcdef';
$str = 'abcdef';
$shuffled = str_shuffle($str);
$shuffled = str_shuffle($str);
// ستعيد شيئًا كهذا: bfdaec
// ستعيد شيئًا كهذا: bfdaec
echo $shuffled;
echo $shuffled;
?>
?>
</syntaxhighlight>
</syntaxhighlight>


== انظر أيضًا ==
== انظر أيضًا ==
* الدالة shuffle()‎: خلط مصفوفة.
* الدالة <code>[[PHP/shuffle|shuffle()‎]]</code>: خلط مصفوفة.
* الدالة rand()‎: توليد عدد صحيح عشوائي.
* الدالة <code>[[PHP/rand|rand()‎]]</code>: توليد عدد صحيح عشوائي.


== مصادر ==
== مصادر ==
* [http://php.net/manual/en/function.str-shuffle.php صفحة الدالة str_shuffle في توثيق PHP الرسمي.]
* [http://php.net/manual/en/function.str-shuffle.php صفحة الدالة str_shuffle في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP String]]

المراجعة الحالية بتاريخ 12:56، 9 أبريل 2018

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

تخلط الدالة str_shuffle()‎ المحارف في السلسلة النصية عشوائيًا.

الوصف

string str_shuffle ( string $str )

تُغَيِّرُ الدالة str_shuffle()‎ السلسلة النصية. يُنشَأ الخليط من كل ما هو ممكن.

تحذير: هذه الدالة لا تولد قيم آمنة مشفرة، يجب ألا تستخدم لأغراض التشفير. إذا كنت بحاجة إلى قيمة آمنة مشفرة، ففكر في استخدام الدالة random_int()‎ أو الدالة random_bytes()‎ أو الدالة openssl_random_pseudo_bytes()‎ بدلاً من ذلك.

المعاملات

str

السلسلة المدخلة.

القيم المعادة

تعيد الدالة str_shuffle()‎ سلسلة نصية معدلَّة.

التغييرات

الإصدار الوصف
7.1.0 غُيِّرت الخوارزمية العشوائية الداخلية لاستخدام  "مولد رقم Mersenne Twister العشوائي" بدلاً من الدالة rand.

أمثلة

المثال 1: مثال على الدالة str_shuffle()‎

<?php
$str = 'abcdef';
$shuffled = str_shuffle($str);
// ستعيد شيئًا كهذا: bfdaec
echo $shuffled;
?>

انظر أيضًا

  • الدالة shuffle()‎: خلط مصفوفة.
  • الدالة rand()‎: توليد عدد صحيح عشوائي.

مصادر