array_keys()‎

(PHP 4, PHP 5, PHP 7)

تعيد الدالة array_keys()‎ كل مفاتيح المصفوفة أو جزءًا منها.

الوصف

array array_keys ( array $array [, mixed $search_value = NULL [, bool $strict = FALSE ]] )

تعيد الدالة المفاتيح سواءً كانت أعدادًا صحيحةً أو سلاسلَ نصيةٍ.

إذا ما حدَّد المستخدم قيمةً للمعامل الاختياري search_value، فستعيد الدالة المفاتيح المرتبطة مع هذه القيمة فقط. أو ستعيد الدالة كل مفاتيح المصفوفة فيما عدا ذلك.

المعاملات

array

مصفوفة تحتوي على المفاتيح التي ستعيدها الدالة.

search_value

إذا ما حدد المستخدم قيمةً لهذا المعامل، فستعيد الدالة فقط المفاتيح المرتبطة مع هذه القيمة..

strict

تحدد قيمة هذا المعامل ما إذا كانت الدالة ستستعمل معامل المقارنة الصارمة (===) أثناء البحث.

القيم المعادة

تعيد مصفوفةً جديدةً تحتوي على مفاتيح المصفوفة.

أمثلة

المثال 1: مثال بسيط عن الدالة array_keys()‎

<?php
$array = array(0 => 100, "color" => "red");
print_r(array_keys($array));

$array = array("blue", "red", "green", "blue", "blue");
print_r(array_keys($array, "blue"));

$array = array("color" => array("blue", "red", "green"),
               "size"  => array("small", "medium", "large"));
print_r(array_keys($array));
?>

نتيجة المثال السابق:

Array
(
    [0] => 0
    [1] => color
)
Array
(
    [0] => 0
    [1] => 3
    [2] => 4
)
Array
(
    [0] => color
    [1] => size
)

انظر أيضًا

• الدالة array_values()‎: تعيد كل قيم المصفوفة.
• الدالة array_combine()‎: تنشئ مصفوفة جديدة عن طريق استخدام أحد المصفوفات للمفاتيح وأخرى للقيم.
• الدالة array_key_exists()‎: تتحقق من وجود أحد المفاتيح أو الفهارس بالمصفوفة.
• الدالة array_search()‎: تبحث داخل المصفوفة عن إحدى القيم وتعيد أول مفتاح مرتبط مع هذه القيمة إذا وُجد.

مصادر

• صفحة الدالة array_keys في توثيق PHP الرسمي.