الفرق بين المراجعتين ل"PHP/implode"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
هارون-بوكرش (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة implode() في PHP}}</noinclude>') |
هارون-بوكرش (نقاش | مساهمات) |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة implode() في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة implode() في PHP}}</noinclude> | ||
| + | (PHP 4, PHP 5, PHP 7) | ||
| + | |||
| + | تَجَمِع الدالة implode() عناصر مصفوفة لتشكِّل سلسلةً نصيةً. | ||
| + | |||
| + | === الوصف === | ||
| + | <syntaxhighlight lang="php"> | ||
| + | string implode ( string $glue , array $pieces ) | ||
| + | |||
| + | string implode ( array $pieces ) | ||
| + | |||
| + | |||
| + | </syntaxhighlight>تَجَمِع الدالة implode() عناصر المصفوفة لِتُشكِّل سلسلة نصية باستعمال المعامل glue. | ||
| + | |||
| + | === ملاحظة === | ||
| + | تقبل الدالة implode() المعاملات في أي ترتيب كانت (لأسباب تاريخية). لكن ومن أجل موافقة الدالة explode() يُرجى إدراج المعاملات حسب الترتيب المُدرج هنا في التوثيق. | ||
| + | |||
| + | === المعاملات === | ||
| + | |||
| + | ==== glue ==== | ||
| + | تُحَدد افتراضيًا بسلسلة نصية فارغة. | ||
| + | |||
| + | ==== pieces ==== | ||
| + | مصفوفة البيانات التي نُشَكِل منها السلسلة النصية. | ||
| + | |||
| + | === القيم المعادة === | ||
| + | تُعيد الدالة implode() سلسلةً نصيةً تحتوي على كل عناصر المصفوفة pieces وبنفس ترتيبها داخل المصفوفة، مع إضافة المعامل glue بين العناصر. | ||
| + | |||
| + | === أمثلة === | ||
| + | |||
| + | ==== المثال 1: مثال بسيط عن الدالة implode() ==== | ||
| + | <syntaxhighlight lang="php"> | ||
| + | <?php | ||
| + | |||
| + | $array = array('lastname', 'email', 'phone'); | ||
| + | |||
| + | $comma_separated = implode(",", $array); | ||
| + | |||
| + | echo $comma_separated; // lastname,email,phone | ||
| + | |||
| + | // ستُعاد سلسلةٌ نصيةٌ فارغة عند استخدام مصفوفة فارغة | ||
| + | |||
| + | var_dump(implode('hello', array())); // string(0) "" | ||
| + | |||
| + | ?> | ||
| + | |||
| + | |||
| + | </syntaxhighlight> | ||
| + | |||
| + | === ملاحظة === | ||
| + | تعدّ الدالة implode() آمنة ثنائيًا (binary-safe، أي يمكن استخدامها على البيانات الممثلة في النظام الثنائي). | ||
| + | |||
| + | === انظر أيضًا === | ||
| + | * explode(): تجزئة السلسلة النصية لعدة سلاسل نصية. | ||
| + | * preg_split(): تجزئة السلسلة النصية بواسطة التعابير النمطية (regular expressions). | ||
| + | * http_build_query(): إنشاء سلسلة نصية استعلامية (query) بترميز URL. | ||
| + | |||
| + | === مصادر === | ||
| + | * صفحة الدالة implode في توثيق PHP الرسمي. | ||
مراجعة 13:40، 5 أبريل 2018
(PHP 4, PHP 5, PHP 7)
تَجَمِع الدالة implode() عناصر مصفوفة لتشكِّل سلسلةً نصيةً.
الوصف
string implode ( string $glue , array $pieces )
string implode ( array $pieces )
تَجَمِع الدالة implode() عناصر المصفوفة لِتُشكِّل سلسلة نصية باستعمال المعامل glue.
ملاحظة
تقبل الدالة implode() المعاملات في أي ترتيب كانت (لأسباب تاريخية). لكن ومن أجل موافقة الدالة explode() يُرجى إدراج المعاملات حسب الترتيب المُدرج هنا في التوثيق.
المعاملات
glue
تُحَدد افتراضيًا بسلسلة نصية فارغة.
pieces
مصفوفة البيانات التي نُشَكِل منها السلسلة النصية.
القيم المعادة
تُعيد الدالة implode() سلسلةً نصيةً تحتوي على كل عناصر المصفوفة pieces وبنفس ترتيبها داخل المصفوفة، مع إضافة المعامل glue بين العناصر.
أمثلة
المثال 1: مثال بسيط عن الدالة implode()
<?php
$array = array('lastname', 'email', 'phone');
$comma_separated = implode(",", $array);
echo $comma_separated; // lastname,email,phone
// ستُعاد سلسلةٌ نصيةٌ فارغة عند استخدام مصفوفة فارغة
var_dump(implode('hello', array())); // string(0) ""
?>
ملاحظة
تعدّ الدالة implode() آمنة ثنائيًا (binary-safe، أي يمكن استخدامها على البيانات الممثلة في النظام الثنائي).
انظر أيضًا
- explode(): تجزئة السلسلة النصية لعدة سلاسل نصية.
- preg_split(): تجزئة السلسلة النصية بواسطة التعابير النمطية (regular expressions).
- http_build_query(): إنشاء سلسلة نصية استعلامية (query) بترميز URL.
مصادر
- صفحة الدالة implode في توثيق PHP الرسمي.