توابع array_column() زبان PHP

توابع آرایه‌ای PHP

مثال

استخراج ستون last_name از مجموعه‌های ثبت شده:

<?php
// نشان‌دهنده مجموعه‌ای از ممکنه‌های بازگشتی از پایگاه داده است
$a = array(
  array(
    'id' => 5698,
    'first_name' => 'Bill',
    'last_name' => 'Gates',
  ),
  array(
    'id' => 4767,
    'first_name' => 'Steve',
    'last_name' => 'Jobs',
  ),
  array(
    'id' => 3809,
    'first_name' => 'Mark',
    'last_name' => 'Zuckerberg',
  )
);
$last_names = array_column($a, 'last_name');
print_r($last_names);
?>

خروجی:

مجموعه
(
  [0] => Gates
  [1] => Jobs
  [2] => Zuckerberg
)

تعریف و نحوه استفاده

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

نحوه استفاده

array_column(array,column_key,index_key);
پارامتر شرح
array ضروری است. تعریف مجموعه چند بعدی مورد استفاده (مجموعه‌های ثبت شده).
column_key

ضروری. ستونی که نیاز به بازگشت دارد.

می‌تواند شامل شاخص یکسانی از ستون‌های آرایه‌ی شمارشی یا کلیدهای شاخص یکسانی از آرایه‌ی مرتبط باشد.

این پارامتر همچنین می‌تواند NULL باشد، در این صورت کل مجموعه بازمی‌گردد (برای تنظیم دوباره کلیدهای مجموعه با استفاده از پارامتر index_key بسیار مفید است).
index_key اختیاری. برای استفاده به عنوان شاخص/کلید برای بازگشت به مجموعه استفاده می‌شود.

جزئیات فنی

مقدار بازگشتی: مجموعه‌ای بازمی‌گرداند، که مقادیر آن از ستون‌های یکسانی از مجموعه ورودی است.
نسخه PHP: 5.5+

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

مثال 1

برای گرفتن ستون last_name از مجموعه‌ی ثبت‌ها، از ستون مربوط به "id" به عنوان کلید استفاده کنید:

<?php
// نشان‌دهنده مجموعه‌ای از ممکنه‌های بازگشتی از پایگاه داده است
$a = array(
  array(
    'id' => 5698,
    'first_name' => 'Bill',
    'last_name' => 'Gates',
  ),
  array(
    'id' => 4767,
    'first_name' => 'Steve',
    'last_name' => 'Jobs',
  )
  array(
    'id' => 3809,
    'first_name' => 'Mark',
    'last_name' => 'Zuckerberg',
  )
);
$last_names = array_column($a, 'last_name', 'id');
print_r($last_names);
?>

خروجی:

مجموعه
(
  [5698] => Gates
  [4767] => Jobs
  [3809] => Zuckerberg
)

توابع آرایه‌ای PHP