PHP array_walk() فونکشن
مثال
مائع میں کسی بھی عنصر پر کاربر کے ذریعے طلب کی گئی فونکشن کا استعمال کرنا:
<?php
function myfunction($value,$key)
{
echo "The key $key has the value $value<br>";
}
$a=array("a"=>"red","b"=>"green","c"=>"blue");
array_walk($a,"myfunction");
?>
تعریف اور کاربرد
array_walk() فونکشن مائع میں کسی بھی عنصر پر کاربر کے ذریعے طلب کی گئی فونکشن کا استعمال کرتا ہے۔ فونکشن میں مائع کا کلچر اور کلچر کا کلچر پارامتر ہیں۔
توضیحات:آپ کسی بائیک گریو فونکشن میں اپنے پہلے پارامتر کو رجوعی (reference) کی شکل میں (&$value) طلب کریں گے تاکہ آپ مائع کی عنصر کی کا مارنا بگاار سکتے ہیں (دیکھ نمونہ 2)۔
نکات:اگر آپ کسی بھی گہرائی کا مائع کو کا مارنا چاہتے ہیں (یعنی ایک مائع میں کسی دوسرے مائع کو شامل کرنا چاہتے ہیں)، تو array_walk_recursive() فونکشن۔
جملہ بنائش
array_walk(array,myfunction,userdata...)
| پارامتر | وصف |
|---|---|
| array | ضروری۔ مائع کو طے کرتا ہے۔ |
| myfunction | ضروری۔ کاربر کے ذریعے طلب کی گئی فونکشن کا نام۔ |
| userdata,... | اختیاری۔ کاربر کے ذریعے طلب کی گئی فونکشن کے پارامتر کو طے کرتا ہے۔ آپ اس فونکشن میں کسی بھی تعداد کا پارامتر دینے میں مجاز ہیں۔ |
توضیح
array_walk() فونکشن اپنے مائع میں کسی بھی عنصر پر فونکشن بازگشتی کا استعمال کرتا ہے۔ اگر کامیاب ہو تو TRUE، درغیر اینم FALSE برآمد کرتا ہے۔
معمولی صورت میں myfunction دو پارامتر قبول کرتا ہے۔array پارامتر کا مال کا بایک پارامتر اور کی نام کا دوسرا پارامتر کی بنا پر کیا جائے گا۔ اگر کوئی اختیاری پارامتر فراہم کیا گیا تو userdata ،کو تیسرا پارامتر کو بایک فونکشن بازگشتی ڈیلیگری کریں گے。
اگر myfunction اگر تعداد پارامترهایی که فونکشن نیاز دارد بیشتر از تعداد پارامترهایی که داده شده است باشد، هر بار که array_walk() فراخوانی میشود myfunction در هر زمان که یک خطا رخ میدهد، یک خطای سطح E_WARNING تولید میشود. این هشدارها میتوانند با استفاده از عملگر خطای PHP (@) قبل از فراخوانی array_walk() یا error_reporting() متوقف شوند.
توضیحات:اگر فونکشن بازگشتی نیاز دارد که مستقیماً بر روی مقادیر آرایه تأثیر بگذارد، میتوان اولین پارامتر فونکشن بازگشتی را به عنوان یک ارجاع指定 کرد: &$value. (مثال 3 را ببینید)
توضیحات:کلیدها و userdata به myfunction در PHP 4.0 به عنوان یک ویژگی جدید اضافه شده است.
جزئیات فنی
| مقدار بازگشتی: | اگر موفق شد TRUE برمیگرداند، در غیر این صورت FALSE. |
| نسخه PHP: | 4+ |
مثالهای بیشتر
مثال 1
تنظیم یک پارامتر:
<?php
فونکشن myfunction($value,$key,$p)
{
echo "$key $p $value<br>";
}
$a=array("a"=>"red","b"=>"green","c"=>"blue");
array_walk($a,"myfunction","has the value");
?>
مثال 2
تغییر یک عنصر آرایه (لطفاً &$value را توجه داشته باشید):
<?php
فونکشن myfunction(&$value,$key)
{
$value="yellow";
}
$a=array("a"=>"red","b"=>"green","c"=>"blue");
array_walk($a,"myfunction");
print_r($a);
?>
