الفرق بين المراجعتين ل"PHP/str split"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
(أضفت المحتوى) |
|||
(مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
سطر 1: | سطر 1: | ||
− | + | <noinclude>{{DISPLAYTITLE:الدالة <code>str_split()</code> في PHP}}</noinclude> | |
− | |||
(PHP 5, PHP 7) | (PHP 5, PHP 7) | ||
− | تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة. | + | تُحَوِّلُ الدالة <code>str_split()</code> السلسلة النصية إلى مصفوفة. |
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
array str_split ( string $string [, int $split_length = 1 ] ) | array str_split ( string $string [, int $split_length = 1 ] ) | ||
− | </syntaxhighlight>تُحَوِّلُ الدالة str_split() السلسلة النصية إلى مصفوفة. | + | </syntaxhighlight>تُحَوِّلُ الدالة <code>str_split()</code> السلسلة النصية إلى مصفوفة. |
== المعاملات == | == المعاملات == | ||
− | === string === | + | === <code>string</code> === |
السلسلة النصية المدخلة. | السلسلة النصية المدخلة. | ||
− | === split_length === | + | === <code>split_length</code> === |
الحد الأقصى لطول القطعة. | الحد الأقصى لطول القطعة. | ||
− | + | == القيم المعادة == | |
− | إذا حُدِّدَ المعامل الاختياري | + | إذا حُدِّدَ المعامل الاختياري <code>split_length</code>، فستقسم المصفوفة المعادة إلى أجزاءٍ طولُ كلٍّ واحد منها يساوي قيمة المعامل <code>split_length</code>، وإلا فسيكون طول كل قطعة حرفًا واحدًا. |
− | تعاد القيمة FALSE إذا كان المعامل split_length أقل من 1. إذا كان طول المعامل split_length يتجاوز طول المعامل | + | تعاد القيمة <code>FALSE</code> إذا كان المعامل <code>split_length</code> أقل من 1. إذا كان طول المعامل <code>split_length</code> يتجاوز طول المعامل <code>string</code>، فستعاد السلسلة بأكملها كعنصر المصفوفة الأول (والوحيد). |
== أمثلة == | == أمثلة == | ||
− | المثال 1: مثال على استخدام الدالة str_split()<syntaxhighlight lang="php"> | + | المثال 1: مثال على استخدام الدالة <code>str_split()</code><syntaxhighlight lang="php"> |
<?php | <?php | ||
− | |||
$str = "Hello Friend"; | $str = "Hello Friend"; | ||
− | |||
$arr1 = str_split($str); | $arr1 = str_split($str); | ||
− | |||
$arr2 = str_split($str, 3); | $arr2 = str_split($str, 3); | ||
− | |||
print_r($arr1); | print_r($arr1); | ||
− | |||
print_r($arr2); | print_r($arr2); | ||
− | |||
?> | ?> | ||
− | </syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang=" | + | </syntaxhighlight>ناتج المثال السابق:<syntaxhighlight lang="text"> |
Array | Array | ||
− | |||
( | ( | ||
− | |||
[0] => H | [0] => H | ||
− | |||
[1] => e | [1] => e | ||
− | |||
[2] => l | [2] => l | ||
− | |||
[3] => l | [3] => l | ||
− | |||
[4] => o | [4] => o | ||
− | |||
[5] => | [5] => | ||
− | |||
[6] => F | [6] => F | ||
− | |||
[7] => r | [7] => r | ||
− | |||
[8] => i | [8] => i | ||
− | |||
[9] => e | [9] => e | ||
− | |||
[10] => n | [10] => n | ||
− | |||
[11] => d | [11] => d | ||
− | |||
) | ) | ||
Array | Array | ||
سطر 75: | سطر 54: | ||
[3] => end | [3] => end | ||
) | ) | ||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== ملاحظات == | == ملاحظات == | ||
− | ملاحظة: ستقسم الدالة str_split() السلسلةَ النصيةَ إلى عدد من البايت بدلاً من الأحرف عند التعامل مع سلسلة تُرمَّز فيها المحارف بأكثر من بايت. | + | ملاحظة: ستقسم الدالة <code>str_split()</code> السلسلةَ النصيةَ إلى عدد من البايت بدلاً من الأحرف عند التعامل مع سلسلة تُرمَّز فيها المحارف بأكثر من بايت. |
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة chunk_split(): تقسيم سلسلة نصية إلى قطع أصغر. | + | * الدالة <code>[[PHP/chunk split|chunk_split()]]</code>: تقسيم سلسلة نصية إلى قطع أصغر. |
− | * الدالة preg_split(): تقسيم السلسلة النصية بواسطة التعابير النمطية. | + | * الدالة <code>[[PHP/preg split|preg_split()]]</code>: تقسيم السلسلة النصية بواسطة التعابير النمطية. |
− | * الدالة explode(): تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. | + | * الدالة <code>[[PHP/explode|explode()]]</code>: تقسيم سلسلة نصية بواسطة سلسلة نصية أخرى. |
− | * الدالة count_chars(): إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. | + | * الدالة <code>[[PHP/count chars|count_chars()]]</code>: إعادة معلومات حول الأحرف المستخدمة في سلسلة نصية. |
− | * الدالة str_word_count(): إعادة معلومات حول الكلمات المستخدمة في سلسلة نصية. | + | * الدالة <code>[[PHP/str word count|str_word_count()]]</code>: إعادة معلومات حول الكلمات المستخدمة في سلسلة نصية. |
− | * حلقة for التكرارية. | + | * [[PHP/for|حلقة for التكرارية]]. |
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.str-split.php صفحة الدالة str_split في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.str-split.php صفحة الدالة str_split في توثيق PHP الرسمي.] | ||
+ | [[تصنيف:PHP]] | ||
+ | [[تصنيف:PHP Function]] | ||
+ | [[تصنيف:PHP String]] |
المراجعة الحالية بتاريخ 12:57، 9 أبريل 2018
(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 التكرارية.