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

مصادر

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