الفرق بين المراجعتين لصفحة: «PHP/implode»
< PHP
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
لا ملخص تعديل |
||
سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تَجَمِع الدالة | تَجَمِع الدالة <code>implode()</code> عناصر مصفوفة لتشكِّل سلسلةً نصيةً. | ||
== الوصف == | |||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
string implode ( string $glue , array $pieces ) | string implode ( string $glue , array $pieces ) | ||
سطر 11: | سطر 11: | ||
</syntaxhighlight>تَجَمِع الدالة implode() عناصر المصفوفة لِتُشكِّل سلسلة نصية باستعمال المعامل glue. | </syntaxhighlight>تَجَمِع الدالة <code>implode()</code> عناصر المصفوفة لِتُشكِّل سلسلة نصية باستعمال المعامل <code>glue</code>. | ||
ملاحظة: تقبل الدالة <code>implode()</code> المعاملات في أي ترتيب كانت (لأسباب تاريخية). لكن ومن أجل موافقة الدالة <code>[[PHP/explode|explode()]]</code> يُرجى إدراج المعاملات حسب الترتيب المُدرج هنا في التوثيق. | |||
تقبل الدالة implode() المعاملات في أي ترتيب كانت (لأسباب تاريخية). لكن ومن أجل موافقة الدالة | |||
== المعاملات == | |||
=== | === <code>glue</code> === | ||
تُحَدد افتراضيًا بسلسلة نصية فارغة. | تُحَدد افتراضيًا بسلسلة نصية فارغة. | ||
=== | === <code>pieces</code> === | ||
مصفوفة البيانات التي نُشَكِل منها السلسلة النصية. | مصفوفة البيانات التي نُشَكِل منها السلسلة النصية. | ||
== القيم المعادة == | |||
تُعيد الدالة implode() سلسلةً نصيةً تحتوي على كل عناصر المصفوفة pieces وبنفس ترتيبها داخل المصفوفة، مع إضافة المعامل glue بين العناصر. | تُعيد الدالة <code>implode()</code> سلسلةً نصيةً تحتوي على كل عناصر المصفوفة <code>pieces</code> وبنفس ترتيبها داخل المصفوفة، مع إضافة المعامل <code>glue</code> بين العناصر. | ||
== أمثلة == | |||
المثال 1: مثال بسيط عن الدالة <code>implode()</code><syntaxhighlight lang="php"> | |||
<syntaxhighlight lang="php"> | |||
<?php | <?php | ||
$array = array('lastname', 'email', 'phone'); | $array = array('lastname', 'email', 'phone'); | ||
$comma_separated = implode(",", $array); | $comma_separated = implode(",", $array); | ||
سطر 40: | سطر 36: | ||
// ستُعاد سلسلةٌ نصيةٌ فارغة عند استخدام مصفوفة فارغة | // ستُعاد سلسلةٌ نصيةٌ فارغة عند استخدام مصفوفة فارغة | ||
var_dump(implode('hello', array())); // string(0) "" | 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. | |||
* | |||
* | |||
* | |||
== مصادر == | |||
* صفحة الدالة implode في توثيق PHP الرسمي. | * [http://php.net/manual/en/function.implode.php صفحة الدالة implode في توثيق PHP الرسمي]. |
مراجعة 17:24، 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.