الفرق بين المراجعتين ل"PHP/array combine"

من موسوعة حسوب
< PHP
اذهب إلى التنقل اذهب إلى البحث
ط (استبدال النص - 'PHP/Function/array' ب'PHP/array')
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/array-combine إلى PHP/array combine: إعادة هيكلة التوثيق)
 
(3 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 7: سطر 7:
 
<syntaxhighlight lang="php">
 
<syntaxhighlight lang="php">
 
array array_combine ( array $keys , array $values )
 
array array_combine ( array $keys , array $values )
</syntaxhighlight>تنشئ الدالة [[PHP/Types/array|مصفوفة]] جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>keys</code> كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>values</code> كقيم مرتبطة بهذه المفاتيح.
+
</syntaxhighlight>تنشئ الدالة [[PHP/array|مصفوفة]] جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>keys</code> كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>values</code> كقيم مرتبطة بهذه المفاتيح.
  
 
== المعاملات ==
 
== المعاملات ==
  
 
=== <code>keys</code> ===
 
=== <code>keys</code> ===
مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى [[PHP/Types/string|سلسلة نصية]].
+
مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى [[PHP/string|سلسلة نصية]].
  
 
=== <code>values</code> ===
 
=== <code>values</code> ===
سطر 56: سطر 56:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* <code>[[PHP/array-merge|array_merge()‎]]</code>: دمج مصفوفة أو أكثر.
+
* <code>[[PHP/array_merge|array_merge()‎]]</code>: دمج مصفوفة أو أكثر.
* <code>[[PHP/array-walk|array_walk()‎]]</code>: تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة.
+
* <code>[[PHP/array_walk|array_walk()‎]]</code>: تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة.
* <code>[[PHP/array-values|array_values()]]</code>‎: إعادة جميع القيم من المصفوفة.
+
* <code>[[PHP/array_values|array_values()]]</code>‎: إعادة جميع القيم من المصفوفة.
  
 
== مصادر ==
 
== مصادر ==

المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018

(PHP 5, PHP 7)

تنشئ الدالة array_combine()‎ مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى.

الوصف

array array_combine ( array $keys , array $values )

تنشئ الدالة مصفوفة جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل keys كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل values كقيم مرتبطة بهذه المفاتيح.

المعاملات

keys

مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى سلسلة نصية.

values

مصفوفة من القيم تربط الدالة بينها وبين المفاتيح.

القيم المعادة

تعيد الدالة مصفوفة جديدة ناتجة عن دمج مصفوفتي المفاتيح والقيم، وتعيد FALSE إذا كان عدد العناصر فى المصفوفتين غير متساوٍ.

الأخطاء والاستثناءات

ترمي الدالة خطأ من نوع E_WARNING إذا كان عدد العناصر في مصفوفتي القيم والمفاتيح غير متساوٍ.

سجل التغييرات

الإصدار الوصف
5.4.0 أصدرت النسخ السابقة خطأً من نوع E_WARNING وأعادت FALSE إذا كانت المصفوفات الفارغة.

أمثلة

المثال 1: استخدام بسيط للدالة array_combine()‎

<?php
$a = array('green', 'red', 'yellow');
$b = array('avocado', 'apple', 'banana');
$c = array_combine($a, $b);

print_r($c);
?>

نتيجة المثال السابق:

Array
(
    [green]  => avocado
    [red]    => apple
    [yellow] => banana
)

انظر أيضًا

  • array_merge()‎: دمج مصفوفة أو أكثر.
  • array_walk()‎: تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة.
  • array_values()‎: إعادة جميع القيم من المصفوفة.

مصادر