الدالة str_split()‎ في 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 التكرارية.

مصادر

• صفحة الدالة str_split‎ في توثيق PHP الرسمي.