الفرق بين المراجعتين لصفحة: «PHP/implode»
< PHP
هارون-بوكرش (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة implode() في PHP}}</noinclude>' |
لا ملخص تعديل |
||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة implode() في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>implode()</code> في PHP}}</noinclude> | ||
(PHP 4, PHP 5, PHP 7) | |||
تَجَمِع الدالة <code>implode()</code> عناصر مصفوفة لتشكِّل سلسلةً نصيةً. | |||
== الوصف == | |||
<syntaxhighlight lang="php"> | |||
string implode ( string $glue , array $pieces ) | |||
string implode ( array $pieces ) | |||
</syntaxhighlight>تَجَمِع الدالة <code>implode()</code> عناصر المصفوفة لِتُشكِّل سلسلة نصية باستعمال المعامل <code>glue</code>. | |||
ملاحظة: تقبل الدالة <code>implode()</code> المعاملات في أي ترتيب كانت (لأسباب تاريخية). لكن ومن أجل موافقة الدالة <code>[[PHP/explode|explode()]]</code> يُرجى إدراج المعاملات حسب الترتيب المُدرج هنا في التوثيق. | |||
== المعاملات == | |||
=== <code>glue</code> === | |||
تُحَدد افتراضيًا بسلسلة نصية فارغة. | |||
=== <code>pieces</code> === | |||
مصفوفة البيانات التي نُشَكِل منها السلسلة النصية. | |||
== القيم المعادة == | |||
تُعيد الدالة <code>implode()</code> سلسلةً نصيةً تحتوي على كل عناصر المصفوفة <code>pieces</code> وبنفس ترتيبها داخل المصفوفة، مع إضافة المعامل <code>glue</code> بين العناصر. | |||
== أمثلة == | |||
المثال 1: مثال بسيط عن الدالة <code>implode()</code><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>ملاحظة: تعدّ الدالة <code>implode()</code> آمنة ثنائيًا (binary-safe، أي يمكن استخدامها على البيانات الممثلة في النظام الثنائي). | |||
== انظر أيضًا == | |||
* <code>[[PHP/explode|explode()]]</code>: تجزئة السلسلة النصية لعدة سلاسل نصية. | |||
* <code>[[PHP/preg split|preg_split()]]</code>: تجزئة السلسلة النصية بواسطة التعابير النمطية (regular expressions). | |||
* <code>[[PHP/http build query|http_build_query()]]</code>: إنشاء سلسلة نصية استعلامية (query) بترميز URL. | |||
== مصادر == | |||
* [http://php.net/manual/en/function.implode.php صفحة الدالة implode في توثيق PHP الرسمي]. | |||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP String]] | |||
المراجعة الحالية بتاريخ 17:25، 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.