الفرق بين المراجعتين لصفحة: «PHP/array walk recursive»
< PHP
Khaled-yassin (نقاش | مساهمات) طلا ملخص تعديل |
ط نقل عبد اللطيف ايمش صفحة PHP/Function/array-walk-recursive إلى PHP/array walk recursive: إعادة هيكلة التوثيق |
||
| (8 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 2: | سطر 2: | ||
(PHP 5, PHP 7) | (PHP 5, PHP 7) | ||
تُطبّق الدالة <code>()array_walk_recursive</code> الدالة [[PHP | تُطبّق الدالة <code>()array_walk_recursive</code> الدالة [[PHP/callable|callback]] المُقدّمة من المستخدم تكراريًا على كل عنصر في المصفوفة. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
bool array_walk_recursive ( array &$array , callable $callback [, mixed $userdata = NULL ] ) | bool array_walk_recursive ( array &$array , callable $callback [, mixed $userdata = NULL ] ) | ||
</syntaxhighlight>تُطبّق الدالة <code>array_walk_recursive()</code> دالة [[PHP | </syntaxhighlight>تُطبّق الدالة <code>array_walk_recursive()</code> دالة [[PHP/callable|callback]] المُعرّفة بواسطة المستخدم على كل عنصر في المصفوفة <code>array</code>. وسوف تتكرر هذه الدالة داخل المصفوفات المتشعبة. | ||
= المعاملات = | == المعاملات == | ||
=== <code>array</code> === | === <code>array</code> === | ||
| سطر 15: | سطر 15: | ||
=== <code>callback</code> === | === <code>callback</code> === | ||
عادةً ما تحتاج الدالة <code>callback</code> المُعرّفة من المستخدم إلى معامليْن. الأول قيمة معامل المصفوفة <code>array</code>، والثاني المفتاح أو الفهرس. | عادةً ما تحتاج الدالة <code>callback</code> المُعرّفة من المستخدم إلى معامليْن. الأول قيمة معامل المصفوفة <code>array</code>، والثاني المفتاح أو الفهرس. | ||
ملاحظة: إذا لزم أن تعمل الدالة <code>callback</code> مع القيم الفعلية للمصفوفة، فيجب تعيين أول معامل لدالة <code>callback</code> [[PHP/references|كمرجع]]. بعد ذلك، ستُجرى أي تغييرات على هذه العناصر في المصفوفة الأصلية نفسها. | |||
=== <code>userdata</code> === | === <code>userdata</code> === | ||
إذا | إذا توافر معامل <code>userdata</code> الاختياري، فسيمرر كمعامل ثالث إلى <code>callback</code>. | ||
= القيم المعادة = | == القيم المعادة == | ||
تُعيد الدالة <code>array_walk_recursive()</code> القيمة <code>TRUE</code> عند نجاحها أو <code>FALSE</code> عند فشل تنفيذها. | تُعيد الدالة <code>array_walk_recursive()</code> القيمة <code>TRUE</code> عند نجاحها أو <code>FALSE</code> عند فشل تنفيذها. | ||
| سطر 40: | سطر 42: | ||
b holds banana | b holds banana | ||
sour holds lemon | sour holds lemon | ||
</syntaxhighlight>قد تلاحظ أن المفتاح | </syntaxhighlight>قد تلاحظ أن المفتاح <code>sweet</code> لا يُعرض أبدًا. ولن يُمرَّر أيُّ مفتاحٍ يحمل مصفوفة إلى الدالة. | ||
== أنظر أيضًا == | == أنظر أيضًا == | ||
* الدالة <code>[[PHP/ | * الدالة <code>[[PHP/array_walk|array_walk()]]</code>: تطبيق دالة معرَّفة من المستخدم على كل عنصر في المصفوفة. | ||
* معلومات حول النوع [[PHP | * معلومات حول النوع [[PHP/callable|callback]]. | ||
== مصادر == | == مصادر == | ||
* [http://php.net/manual/en/function.array-walk-recursive.php صفحة الدالة | * [http://php.net/manual/en/function.array-walk-recursive.php صفحة الدالة array_walk_recursive في توثيق PHP الرسمي]. | ||
[[تصنيف:PHP]] | [[تصنيف:PHP]] | ||
[[تصنيف:PHP Function]] | [[تصنيف:PHP Function]] | ||
[[تصنيف:PHP Array]] | [[تصنيف:PHP Array]] | ||
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(PHP 5, PHP 7)
تُطبّق الدالة ()array_walk_recursive الدالة callback المُقدّمة من المستخدم تكراريًا على كل عنصر في المصفوفة.
الوصف
bool array_walk_recursive ( array &$array , callable $callback [, mixed $userdata = NULL ] )
تُطبّق الدالة array_walk_recursive() دالة callback المُعرّفة بواسطة المستخدم على كل عنصر في المصفوفة array. وسوف تتكرر هذه الدالة داخل المصفوفات المتشعبة.
المعاملات
array
المصفوفة المدخلة.
callback
عادةً ما تحتاج الدالة callback المُعرّفة من المستخدم إلى معامليْن. الأول قيمة معامل المصفوفة array، والثاني المفتاح أو الفهرس.
ملاحظة: إذا لزم أن تعمل الدالة callback مع القيم الفعلية للمصفوفة، فيجب تعيين أول معامل لدالة callback كمرجع. بعد ذلك، ستُجرى أي تغييرات على هذه العناصر في المصفوفة الأصلية نفسها.
userdata
إذا توافر معامل userdata الاختياري، فسيمرر كمعامل ثالث إلى callback.
القيم المعادة
تُعيد الدالة array_walk_recursive() القيمة TRUE عند نجاحها أو FALSE عند فشل تنفيذها.
أمثلة
المثال 1: مثال على الدالة array_walk_recursive()
<?php
$sweet = array('a' => 'apple', 'b' => 'banana');
$fruits = array('sweet' => $sweet, 'sour' => 'lemon');
function test_print($item, $key)
{
echo "$key holds $item\n";
}
array_walk_recursive($fruits, 'test_print');
?>
سوف تكون مُخرجات المثال أعلاه كالتالي:
a holds apple
b holds banana
sour holds lemon
قد تلاحظ أن المفتاح sweet لا يُعرض أبدًا. ولن يُمرَّر أيُّ مفتاحٍ يحمل مصفوفة إلى الدالة.
أنظر أيضًا
- الدالة
array_walk(): تطبيق دالة معرَّفة من المستخدم على كل عنصر في المصفوفة. - معلومات حول النوع callback.