الفرق بين المراجعتين لصفحة: «PHP/array combine»
< PHP
Ibrahem-atef (نقاش | مساهمات) إنشاء صفحة جديدة |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/array-combine إلى PHP/array combine: إعادة هيكلة التوثيق |
||
| (8 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>array_combine()</code>}}</noinclude> | |||
(PHP 5, PHP 7) | |||
تنشئ الدالة <code>array_combine()</code> مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى. | |||
تنشئ الدالة array_combine() مصفوفةً جديدةً عن طريق استخدام المفاتيح من أحد المصفوفات والقيم من مصفوفة أخرى. | |||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
array array_combine ( array $keys , array $values ) | array array_combine ( array $keys , array $values ) | ||
</syntaxhighlight>تنشئ الدالة مصفوفة جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل keys كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل values كقيم مرتبطة بهذه المفاتيح. | </syntaxhighlight>تنشئ الدالة [[PHP/array|مصفوفة]] جديدة عن طريق استخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>keys</code> كمفاتيح، واستخدام قيم المصفوفة المُمَرََرة عبر المعامل <code>values</code> كقيم مرتبطة بهذه المفاتيح. | ||
== المعاملات == | == المعاملات == | ||
=== <code>keys</code> === | |||
مصفوفة من المفاتيح التي تستخدمها هذه الدالة. أي قيمة غير مقبولة كمفتاح ستُحَوََل إلى [[PHP/string|سلسلة نصية]]. | |||
=== <code>values</code> === | |||
مصفوفة من القيم تربط الدالة بينها وبين المفاتيح. | مصفوفة من القيم تربط الدالة بينها وبين المفاتيح. | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيد الدالة | تعيد الدالة مصفوفة جديدة ناتجة عن دمج مصفوفتي المفاتيح والقيم، وتعيد <code>FALSE</code> إذا كان عدد العناصر فى المصفوفتين غير متساوٍ. | ||
== | == الأخطاء والاستثناءات == | ||
ترمي الدالة خطأ من نوع E_WARNING إذا كان عدد العناصر في مصفوفتي القيم والمفاتيح غير متساوٍ. | ترمي الدالة خطأ من نوع <code>E_WARNING</code> إذا كان عدد العناصر في مصفوفتي القيم والمفاتيح غير متساوٍ. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
{| class="wikitable" | {| class="wikitable" | ||
!الإصدار | |||
!الوصف | |||
|- | |- | ||
|5.4.0 | |5.4.0 | ||
|أصدرت النسخ السابقة | |أصدرت النسخ السابقة خطأً من نوع <code>E_WARNING</code> وأعادت <code>FALSE</code> إذا كانت المصفوفات الفارغة. | ||
|} | |} | ||
== أمثلة == | == أمثلة == | ||
المثال 1: استخدام بسيط للدالة array_combine()<syntaxhighlight lang="php"> | المثال 1: استخدام بسيط للدالة <code>array_combine()</code><syntaxhighlight lang="php"> | ||
<?php | <?php | ||
$a = array('green', 'red', 'yellow'); | $a = array('green', 'red', 'yellow'); | ||
$b = array('avocado', 'apple', 'banana'); | $b = array('avocado', 'apple', 'banana'); | ||
$c = array_combine($a, $b); | $c = array_combine($a, $b); | ||
print_r($c); | print_r($c); | ||
?> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
نتيجة المثال السابق:<syntaxhighlight lang="php"> | نتيجة المثال السابق:<syntaxhighlight lang="php"> | ||
Array | Array | ||
( | ( | ||
[green] => avocado | |||
[red] => apple | |||
[yellow] => banana | |||
) | |||
</syntaxhighlight> | |||
== انظر أيضًا == | |||
* <code>[[PHP/array_merge|array_merge()]]</code>: دمج مصفوفة أو أكثر. | |||
* <code>[[PHP/array_walk|array_walk()]]</code>: تطبيق دالة مُعرَّفة من المستخدم على جميع عناصر المصفوفة. | |||
* <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(): إعادة جميع القيم من المصفوفة.