الفرق بين المراجعتين لصفحة: «PHP/str split»
< PHP
أضفت المحتوى |
لا ملخص تعديل |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 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 التكرارية.