الدالة str_split() في PHP
< PHP
(PHP 5, PHP 7)
تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة.
الوصف
array str_split ( string $string [, int $split_length = 1 ] )
تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة.
المعاملات
string
السلسلة النصية المدخلة.
split_length
الحد الأقصى لطول القطعة.
القيم المعادة
إذا حُدِّدَ المعامل الاختياري split_length، فستقسم المصفوفة المعادة إلى أجزاءٍ طولُ كلٍّ واحد منها يساوي قيمة المعامل split_length، وإلا فسيكون طول كل قطعة حرفًا واحدًا.
تعاد القيمة FALSE إذا كان المعامل split_length أقل من 1. إذا كان طول المعامل split_length يتجاوز طول المعامل string، فستعاد السلسلة بأكملها كعنصر المصفوفة الأول (والوحيد).
أمثلة
المثال 1: مثال على استخدام الدالة str_split()
<?php
$str = "Hello Friend";
$arr1 = str_split($str);
$arr2 = str_split($str, 3);
print_r($arr1);
print_r($arr2);
?>
ناتج المثال السابق:
Array
(
[0] => H
[1] => e
[2] => l
[3] => l
[4] => o
[5] =>
[6] => F
[7] => r
[8] => i
[9] => e
[10] => n
[11] => d
)
Array
(
[0] => Hel
[1] => lo
[2] => Fri
[3] => end
)
ملاحظات
ملاحظة: ستقسم الدالة str_split() السلسلةَ النصيةَ إلى عدد من البايت بدلاً من الأحرف عند التعامل مع سلسلة تُرمَّز فيها المحارف بأكثر من بايت.
انظر أيضًا
- الدالة chunk_split(): تقسيم سلسلة نصية إلى قطع أصغر.
- الدالة preg_split(): تقسيم السلسلة النصية بواسطة التعابير النمطية.
- الدالة explode(): تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى.
- الدالة count_chars(): إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية.
- الدالة str_word_count(): إعادة معلومات حول الكلمات المستخدمة في سلسلة نصية.
- حلقة for التكرارية.