الدالة implode() في PHP
< PHP
(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.