الفرق بين المراجعتين لصفحة: «PHP/implode»

من موسوعة حسوب
< PHP
لا ملخص تعديل
لا ملخص تعديل
سطر 2: سطر 2:
(PHP 4, PHP 5, PHP 7)
(PHP 4, PHP 5, PHP 7)


تَجَمِع الدالة ‎implode()‎ عناصر مصفوفة لتشكِّل سلسلةً نصيةً.
تَجَمِع الدالة ‎<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()‎ المعاملات في أي ترتيب كانت (لأسباب تاريخية). لكن ومن أجل موافقة الدالة ‎explode()‎ يُرجى إدراج المعاملات حسب الترتيب المُدرج هنا في التوثيق.


=== المعاملات ===
== المعاملات ==


==== ‎glue ====
=== ‎<code>glue</code> ===
تُحَدد افتراضيًا بسلسلة نصية فارغة.
تُحَدد افتراضيًا بسلسلة نصية فارغة.


==== ‎pieces ====
=== ‎<code>pieces</code> ===
مصفوفة البيانات التي نُشَكِل منها السلسلة النصية.
مصفوفة البيانات التي نُشَكِل منها السلسلة النصية.


=== القيم المعادة ===
== القيم المعادة ==
تُعيد الدالة implode()‎ سلسلةً نصيةً تحتوي على كل عناصر المصفوفة pieces وبنفس ترتيبها  داخل المصفوفة، مع إضافة المعامل glue بين العناصر.
تُعيد الدالة <code>implode()‎</code> سلسلةً نصيةً تحتوي على كل عناصر المصفوفة <code>pieces</code> وبنفس ترتيبها  داخل المصفوفة، مع إضافة المعامل <code>glue</code> بين العناصر.


=== أمثلة ===
== أمثلة ==
 
المثال 1: مثال بسيط عن الدالة <code>implode()‎</code><syntaxhighlight lang="php">
==== المثال 1: مثال بسيط عن الدالة implode()‎ ====
<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، أي يمكن استخدامها على البيانات الممثلة في النظام الثنائي).


</syntaxhighlight>
== انظر أيضًا ==
 
* ‎<code>[[PHP/explode|explode()]]</code>‎: تجزئة السلسلة النصية لعدة سلاسل نصية.
=== ملاحظة ===
* ‎<code>[[PHP/preg split|preg_split()‎]]</code>: تجزئة السلسلة النصية بواسطة التعابير النمطية (regular expressions).
تعدّ الدالة implode()‎ آمنة ثنائيًا (binary-safe، أي يمكن استخدامها على البيانات الممثلة في النظام الثنائي).
* ‎<code>[[PHP/http build query|http_build_query()]]</code>‎: إنشاء سلسلة نصية استعلامية (‎query) بترميز URL.
 
=== انظر أيضًا ===
* ‎explode()‎: تجزئة السلسلة النصية لعدة سلاسل نصية.
* ‎preg_split()‎: تجزئة السلسلة النصية بواسطة التعابير النمطية (regular expressions).
* ‎http_build_query()‎: إنشاء سلسلة نصية استعلامية (‎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.

مصادر