[Mohsen Omidvar]

در این بخش در مورد توابع کار با آرایه ها حرف میزنیم.سعی میکنم مختصر و مفید در مورد همه توابعی که مربوط به آرایه ها هستن توضیح بدم.

Array_change_key_case(Array,Case)

این تابع تمام کلید های داخل آرایه رو به حروف بزرگ یا کوچک تبدیل میکنه.
پارامتر اول این تابع یک ارایه میگیره و پارامتر دوم CASE_LOWER برای تبدیل به حروف کوچک و CASE_UPPER برای تبدیل کلیدها به حروف کوچک استفاده میشن.
مثال :

کد php:

$input_array = array("FirSt" => 1, "SecOnd" => 4);
print_r(array_change_key_case($input_array, CASE_UPPER)); 


خروجی

Array
(
[FIRST] => 1
[SECOND] => 4
)

مثال ۲ :

کد php:

$arr = array('first'=>'Apple','Second'=>'orange');
print_r(array_change_key_case($arr, CASE_UPPER));); 


خروجی
Array
(
[FIRST] => Apple
[SECOND] => orange
)
در مثال دوم مشاهده میکنید که فقط کلیدهای آرایه به حروف بزرگ تبدیل شدند.

کد php:

Array Array_combine ( Array , Array ) 


این تابع دو آرایه رو به یک آرایه تبدیل مبکنه.به این صورت که آرایه ای که در پارامتر اول بهش میدیم به عنوان کلید و آرایه پارامتر دوم به عنوان مقادیر آرایه جدید در نظر گرفته میشن.
مثال :

کد 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
)
میبینید که تمام مقادیر آرایه اول به عنوان کلید و تمام مقادیر آرایه دوم به عنوان مقدار آرایه جدید در نظر گرفته شدن. در صورتی که تعداد عناصر آرایه اول با آرایه دوم برابر نباشه FALSE برگشت داده میشه.

Array Array_count_values ( Array )

تعداد تکرار کلیدهای یک آرایه رو به صورت یک آرایه انجمنی برمیگردونه.
مثال :

کد php:

$array = array(1, "hello", 1, "world", "hello");
print_r(array_count_values($array)); 


خروجی

Array
(
[1] => 2
[hello] => 2
[world] => 1
)

در آرایه $array عدد ۱ دوبار تکرار شده ، hello هم دوبار تکرار شده و world یک بار تکرار شده.خروجی این تابع هم به همین صورت تعداد مقادیر تکرار شده در آرایه رو برمیگردونه.

Array_diff(Array1,Array2,Array3,…)

با استفاده از این تابع میتونید یک ارایه رو با چند آرایه دیگه مقایسه کنید.در این تابع مقادیر(values) آرایه اول با مقادیر آرایه های بعدی مقابسه میشه و value هایی که در آرایه اول باشه اما در آرایه های بعدی نباشه برگشت داده میشه.

کد php:

$a1=array(0=>"Cat",1=>"Dog",2=>"Horse");
$a2=array(3=>"Horse",4=>"Dog",5=>"Fish");
print_r(array_diff($a1,$a2)); 


خروجی

Array ( [0] => Cat )

Array_diff_assoc($Array1,$Array2,$Array3,…)

مقایسه کلیدها و مقادیر دو یا چند آرایه.کلیدها و مقادیر آرایه اول با بقیه آرایه ها مقایسه میشن و در صورتی که در یک کلید و مقدار در آرایه اول بود اما در بقیه ارایه ها نبود برگشت داده میشه.

کد php:

$a1=array(0=>"Cat",1=>"Dog",2=>"Horse");
$a2=array(0=>"Rat",1=>"Horse",2=>"Dog");
$a3=array(0=>"Horse",1=>"Dog",2=>"Cat");
print_r(array_diff_assoc($a1,$a2,$a3)); 


خروجی
Array ( [0] => Cat [2] => Horse )

Array_diff_key(Array1 , Array2,…)

مقادیر و کلیدهای یک یا چند آرایه رو با بقیه آرایه ها مقایسه میکنه و درصورتی که کلیدی در آرایه اول بود اما در بقیه ارایه ها نبود برگشت داده میشه.

1
$a1=array(0=>"Cat",1=>"Dog",2=>"Horse");
2
$a2=array(2=>"Bird",3=>"Rat",4=>"Fish");
3
$a3=array(5=>"Horse",6=>"Dog",7=>"Bird");
4
print_r(array_diff_key($a1,$a2,$a3));

خروجی
Array ( [0] => Cat [1] => Dog )

Array_fill(Start , Number , Value)

تابعی برای پر کردن یک آرایه. پارامتر اول عدد شروع کلید آرایه.پارامتر دوم تعداد عناصری که باید به آرایه اضافه بشه و پارمتر سوم مقداری که باید به آرایه داده بشه.

کد php:

$a=array_fill(2,3,"Dog");
print_r($a); 


خروجی

Array ( [2] => Dog [3] => Dog [4] => Dog )

کلید ارایه از ۲ شروع شده و ۳ عنصر به آرایه اضافه شده با مقدار “Dog”

Array_flip()

این تابع جای کلیدها و مقادیر رو عوض میکنه.

کد php:

$a=array(0=>"Dog",1=>"Cat",2=>"Horse");
print_r(array_flip($a)); 


خروجی
Array ( [Dog] => 0
[Cat] => 1 [Horse] => 2 )

Array_key_exists(Key , Array)

این تابع چک میکنه که آیا یک کلید خاص در آرایه وجود داره یا نه .پارامتر اول کلید رو میگیره و پارامتر دوم آرایه

کد php:

$a=array("a"=>"Dog","b"=>"Cat");
 if (array_key_exists("a",$a))
 {
 echo "Key exists!";
 }
 else
 {
 echo "Key does not exist!";
 }
//Key exists! 


Array_keys(Array)

تمام کلیدهای آرایه رو به صورت یک آرایه بر میگردونه.

کد php:

$ar = array('a'=>'Dog','b'=>'cat','c'=>'horse');
 print_r(array_keys($ar)); 


Array_map(Function , Array1 , Array2 , …)

این تابع هر مقدار از آرایه رو به یک تابع ارسال میکنه و نتیجه تابع رو به صورت یک آرایه بر میگردونه.
مثال :

کد php:

function sqr($v)
 {
 return $v * $v;
 }
 $ar = array(2 , 3 , 4 , 5 , 6 );
 print_r(array_map('foo' , $ar)); 


خروجی :

Array ( [0] => 4 [1] => 9 [2] => 16 [3] => 25 [4] => 36 )

در صورتی که نیاز به فراخوانی متد یک کلاس در تابع array_map باشیم پارامتر اول رو به صورت یک آرایه تعریف میکنیم که مقدار اول آرایه نام کلاس ومقدار دوم نام تابع مورد نظر است :

کد php:

class foo{
function bar($a){ return $a * $a );
}
array_map(array('foo','bar') , $arr)); 


Array_merg(Array1 , Array2 , …)

ادغام دو یا چند آرایه باهم.

$a1=array("a"=>"Horse","b"=>"Dog");
$a2=array("c"=>"Cow","b"=>"Cat");
print_r(array_merge($a1,$a2));
خروجی :

Array ( [a] => Horse => Cat => Cow )

اگر کلید همنام در آرایه ها وجود داشته باشه کلید و مقدار آخرین آرایه در آرایه جدید قرار میگیره .

[b]Array_pop(Array)

آخرین عنصر آرایه رو حذف میکنه .

کد php:

$a=array("Dog","Cat","Horse");
array_pop($a);
print_r($a);
Array ( [0] => Dog [1] => Cat )
Array_product(Array) 


حاصلضرب تمام مقادیر آرایه رو حساب میکنه و بر میگردونه .

کد php:

$a=array(5,5);
echo(array_product($a));// 25 


Array_push(Array , Value1,Value2,…)

یک یا چند مقدار جدید رو به انتهای آرایه اضافه میکنه.


$a=array("Dog","Cat");
array_push($a,"Horse","Bird");
print_r($a);
خروجی

Array ( [0] => Dog [1] => Cat [2] => Horse [3] => Bird )

Array_rand(Array ,Number)

به صورت تصادفی یک کلید از آرایه رو بر میگردونه.در قسمت number اگر عددی قرار داشته باشه به همون تعداد کلید های تصادفی از آرایه برگشت داده میشه .

کد php:

$a=array("a"=>"Dog","b"=>"Cat","c"=>"Horse");
print_r(array_rand($a,2)); 


خروجی
Array ( [0] => c [1] => b )

Array_reduce(Array , Function , Initial)

این تابع مقادیر یک آرایه رو به یک تابع از قبل تعریف شده ارسال میکنه و نتیجه رو به صورت string (رشته) برمیگردونه.
initial یک مقدار جدا برای ارسال به آرایه است.

کد php:

function myfunction($v1,$v2)
{
return $v1 . "-" . $v2;
}
$a=array("Dog","Cat","Horse");
print_r(array_reduce($a,"myfunction"));//-Dog-Cat-Horse 


Array_revers(Array , Preserve)

برای عکس کردن یک آرایه از این تابع استفاده میشه
خروجی
Array (

=> Horse => Cat [a] => Dog )

[b]Array_search(Value , Array , Restrict)

جستجو در بین مقادیر آرایه و برگشت دادن کلید .

strict : اگر true باشه بین '۵' و ۵ فرق قائل میشه.به صورت پیش فرض false

کد php:

$a=array("a"=>"5","b"=>5,"c"=>"5");

echo array_search(5,$a,true); // b 


Array_shift(Array)

عنصر اول از آرایه رو حذف و برگشت میده .

کد php:

$a=array("a"=>"Dog","b"=>"Cat","c"=>"Horse");
echo array_shift($a);
print_r ($a); 


Array_slice(Array, Start , Length)

قسمتی از آرایه رو برمیگردونه .

کد php:

$a=array(0=>"Dog",1=>"Cat",2=>"Horse",3=>"Bird");
print_r(array_slice($a,1,2)); 


خروجی
Array ( [0] => Cat [1] => Horse )

Array_splice(Array, Start, Length, Array)

قسمتهایی از آرایه رو حذف میکنه و با عناصر جدید جایگزین میکنه.و یک آرایه جدید برمیگردونه.

کد php:

$a1=array(0=>"Dog",1=>"Cat",2=>"Horse",3=>"Bird");
$a2=array(0=>"Tiger",1=>"Lion");
array_splice($a1,0,2,$a2);
print_r($a1); 


خروجی
Array ( [0] => Tiger [1] => Lion [2] => Horse [3] => Bird )

Array_sum(Array)

جمع تمام مقادیر آرایه رو بر میگردونه.

کد php:

$a=array(0=>"5",1=>"15",2=>"25");
echo array_sum($a);
// 45 


Array_unique(Array)

مقادیر (values) مشابه رو از آرایه حذف میکنه.در صورتی که مقادیر مشابه وجود داشته باشن اولین مقدار نگه داشته میشه و بقیه مقادیر مشابه حذف میشن.

کد php:

$a=array("a"=>"Cat","b"=>"Dog","c"=>"Cat");
print_r(array_unique($a)); 


خروجی
Array ( [a] => Cat => Dog )

[b]Array_values(Array)

تمام مقادیر(values) یک آرایه رو به صورت یک آرایه جدید برمیگردونه.

کد php:

$a=array("a"=>"Cat","b"=>"Dog","c"=>"Horse");
print_r(array_values($a)); 


خروجی
Array ( [0] => Cat [1] => Dog [2] => Horse )

Array_walk(Array,Function ,Parameter…)

تمام مقادیر آرایه رو به یک تابع از پیش تعریف شده ارسال میکنه.(مانند تابع array_map) .پارامترهای ورودی تابع تعریف شده کلیدها و مقادیر آرایه هستند.

کد php:

function myfunction($value,$key)
{
    echo "The key $key has the value $value";
}
$a=array("a"=>"Cat","b"=>"Dog","c"=>"Horse");
array_walk($a,"myfunction"); 


خروجی

The key a has the value Cat
The key b has the value Dog
The key c has the value Horse

Count(Array)

تعداد عناصر آرایه رو بر میگردونه.

کد php:

$people = array("Peter", "Joe", "Glenn", "Cleveland");
$result = count($people);
echo $result;
// 4 


Current(Array)

مقدار فعلی یک آرایه رو بر میگردونه.

کد php:

$people = array("Peter", "Joe", "Glenn", "Cleveland");
echo current($people) . "
";
// Peter 


end(array)

آخرین مقدار آرایه رو بر میگردونه.

کد php:

<pre class="brush: php; gutter: true">
$people = array("Peter", "Joe", "Glenn", "Cleveland");
echo current($people)."  ";
echo end($people); 


خروجی
Peter
Cleveland

Extract(Array, Extract_rules,Prefix)
این تابع یک آرایه انجمنی رو به عنوان اولین پارامتر میگیره و کلیدهای آرایه رو به متغیر تبدیل میکنه. کلیدهای آرایه نام متغیر و مقادیر کلیدها به مقدار متغیر تبدیل میشن.

کد php:

$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array);
echo "$a = $a; $b = $b; $c = $c"; 


extract_rules :
- EXTR_OVERWRITE : اگر متغیر از قبل وجود داشته باشه از بین میره و مقدار جدید داخلش قرار میگیره
- EXTR_SKIP : اگر متغیراز قبل وجود داشته باشه جایگزین نمیشه
- EXTR_PREFIX_SAME : درصورت همنام بودن یک پیشوند به متغیر اضافه میشه.
- EXTR_PREFIX_ALL : به همه متغیرها یک پیشوند اختصاص داده میشه
- EXTR_PREFIX_INVALID : فقط به کلیدهایی که نام مجاز برای متغیر شدن ندارن یا کلیدهای عددی یک پیشوند اضافه میشه.
- EXTR_IF_EXISTS : فقط اگر متغیر وجود داشته باشه جایگزین میشه
- EXTR_PREFIX_IF_EXISTS : در صورتی که متغیر از قبل موجود باشه یک پیشوند به متغیر جدید اضافه میشه.
- EXTR_REFS : متغیرها رو به صورت reference میسازه

prefix : اگر EXTR_PREFIX_SAME, EXTR_PREFIX_ALL, EXTR_PREFIX_INVALID EXTR_PREFIX_IF_EXISTS استفاده بشه پیشوندی که در این قسمت مشخص میشه به متغیر ها داده میشه.

کد php:

$a = 'Original';
$my_array = array("a" => "Cat","b" => "Dog", "c" => "Horse");
extract($my_array, EXTR_PREFIX_SAME, 'dup');
echo "$a = $a; $b = $b; $c = $c; $dup_a = $dup_a;";
// $a = Original; $b = Dog; $c = Horse; $dup_a = Cat; 


In_array(Search ,Array,Type)
چک میکنه که آبا مقدار “search” در آرایه وجود داره یا نه.اگر type برابر با true باشه نوع داده هم چک میشه.

کد php:

$people = array("Peter", "Joe", "Glenn", "Cleveland", 23);
if (in_array("23",$people, TRUE))
{
    echo "Match found";
}
else
{
    echo "Match not found";
}
if (in_array("Glenn",$people, TRUE))
{
    echo "Match found";
}
else
{
    echo "Match not found";
}
if (in_array(23,$people, TRUE))
{
    echo "Match found";
}
else
{
    echo "Match not found";
}
<pre class="brush: php; gutter: true">
<blockquote>Match not found Match found Match found</blockquote> 


next(array)
تابع next اشاره گر رو به عنصر بعدی آرایه حرکت میده و مقدار عنصر بعدی رو به خروجی میفرسته.

کد php:

<pre class="brush: php; gutter: true">
$people = array("Peter", "Joe", "Glenn", "Cleveland");
echo current($people) . " ";
echo next($people); 


خروجی
Peter
Joe

Prev(Array)

اشاره گر رو به عنصر قبلی آرایه جرکت میده و به خروجی میفرسته

کد php:

$people = array("Peter", "Joe", "Glenn", "Cleveland");
echo current($people) . " ";
echo next($people) . " ";
echo prev($people); 


خروجی
Peter
Joe
Peter

Range(Low,High,Step)

تابع range یک آرایه میسازه با بازه ای از داده ها.
low : کمترین مقدار
high : بیشترین مقدار
step : مقدار زیاد شدن از کم به زیاد رو مشخص میکنه.

کد php:

$number = range(0,5);
print_r ($number); 


خروجی
Array
(
[0] => 0
[1] => 1
[2] => 2
[3] => 3
[4] => 4
[5] => 5
)

Reset(Array)

انتقال اشاره گر به اولین عنصر آرایه.

کد php:

$people = array("Peter", "Joe", "Glenn", "Cleveland");
echo current($people) . " ";
echo next($people) . " ";
echo reset($people); 


خروجی

Peter
Joe
Peter

Shuffle(Array)

نحوه قرار گیری عناصر داخل آرایه رو به صورت تصادفی تغییر میده و کلیدهای جدیدی به عناصر آرایه نسبت میده.

کد php:

$my_array = array("a" => "Dog", "b" => "Cat", "c" => "Horse");
shuffle($my_array);
print_r($my_array); 


خروجی
Array ( [0] => Cat [1] => Horse [2] => Dog )

Sizeof(Array, Mode)

تعداد عناصر ارایه رو بر میگردونه.mode اگر ۱ تنظیم بشه آرایه های چند بعدی هم تشخیص داده میشه.

کد php:

$people = array("Peter", "Joe", "Glenn", "Cleveland");
$result = sizeof($people);
echo $result;// 4