الفرق بين المراجعتين لصفحة: «PHP/array combine»
< PHP
لا ملخص تعديل |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/array-combine إلى PHP/array combine: إعادة هيكلة التوثيق |
||
| (7 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>array_combine()</code>}}</noinclude> | |||
(PHP 5, PHP 7) | |||
تنشئ الدالة <code>array_combine()</code> مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى. | تنشئ الدالة <code>array_combine()</code> مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى. | ||
| سطر 8: | سطر 7: | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
array array_combine ( array $keys , array $values ) | array array_combine ( array $keys , array $values ) | ||
</syntaxhighlight>تنشئ الدالة [[PHP | </syntaxhighlight>تنشئ الدالة [[PHP/array|مصفوفة]] جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>keys</code> كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>values</code> كقيم مرتبطة بهذه المفاتيح. | ||
== المعاملات == | == المعاملات == | ||
=== <code>keys</code> === | === <code>keys</code> === | ||
مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى [[PHP | مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى [[PHP/string|سلسلة نصية]]. | ||
=== <code>values</code> === | === <code>values</code> === | ||
| سطر 57: | سطر 56: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* array_merge(): دمج مصفوفة أو أكثر. | * <code>[[PHP/array_merge|array_merge()]]</code>: دمج مصفوفة أو أكثر. | ||
* array_walk(): تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة. | * <code>[[PHP/array_walk|array_walk()]]</code>: تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة. | ||
* array_values(): إعادة جميع القيم من المصفوفة. | * <code>[[PHP/array_values|array_values()]]</code>: إعادة جميع القيم من المصفوفة. | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.array-combine.php صفحة الدالة array_combine في توثيق PHP الرسمي.] | * [http://php.net/manual/en/function.array-combine.php صفحة الدالة array_combine في توثيق PHP الرسمي.] | ||
[[تصنيف:PHP]] | |||
[[تصنيف:PHP Function]] | |||
[[تصنيف:PHP Array]] | |||
المراجعة الحالية بتاريخ 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(): إعادة جميع القيم من المصفوفة.