array_keys()
< PHP
(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(): تبحث داخل المصفوفة عن إحدى القيم وتعيد أول مفتاح مرتبط مع هذه القيمة إذا وُجد.