تابع ()array_column

چاپ

تابع ()array_column

PHP Array Reference PHP Array Reference

مثال (تابع ()array_column)

به دست آوردن آخرین نام ها از یک رکورد:

<?php
// An array that represents a possible record set returned from a database
$a = array(
  array(
    'id' => 5698,
    'first_name' => 'Peter',
    'last_name' => 'Griffin',
  ),
  array(
    'id' => 4767,
    'first_name' => 'Ben',
    'last_name' => 'Smith',
  ),
  array(
    'id' => 3809,
    'first_name' => 'Joe',
    'last_name' => 'Doe',
  )
);

$last_names = array_column($a, 'last_name');
print_r($last_names);
?>

خروجی:

Array
(
  [0] => Griffin
  [1] => Smith
  [2] => Doe
)

تعریف و کاربرد

تابع ()array_column، مقادیر را از یک ستون تکی در آرایه ی دربردارنده، برمی گرداند. 


نحوه نوشتن

array_column(array,column_key,index_key);
پارامترهاتوضیحات
array

ضروری. آرایه ی چند بعدی را برای استفاده مشخص می کند. (مجموعه رکوردها).

column_key

ضروری. یک کلید صحیح(عدد صحیح) یا یک نام کلید رشته ای از ستون مقادیر را برای برگرداندن مشخص می کند. این پارامتر همچنین می تواند null باشد تا آرایه های کاملی را برگرداند. (قابل استفاده به همراه index_key برای اندیس گذاری دوباره ی آرایه).

index_key

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

جزئیات تکنیکی

مقدار برگشتی:

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

ورژن php: 5.5+

مثال های بیشتر

مثال 1

به دست آوردن ستون نام ها از یک رکورد، که به وسیله ی ستون 'id' اندیس گذاری شده است:

<?php
// An array that represents a possible record set returned from a database
$a = array(
  array(
    'id' => 5698,
    'first_name' => 'Peter',
    'last_name' => 'Griffin',
  ),
  array(
    'id' => 4767,
    'first_name' => 'Ben',
    'last_name' => 'Smith',
  ),
  array(
    'id' => 3809,
    'first_name' => 'Joe',
    'last_name' => 'Doe',
  )
);

$last_names = array_column($a, 'last_name', 'id');
print_r($last_names);
?>

خروجی:

Array
(
  [5698] => Griffin
  [4767] => Smith
  [3809] => Doe
)

PHP Array Reference PHP Array Reference