الفرق بين المراجعتين ل"PHP/array keys"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
ط (إضافة عنوان الصفحة والتصنيفات) |
ط (نقل عبد اللطيف ايمش صفحة PHP/Function/array-keys إلى PHP/array keys: إعادة هيكلة التوثيق) |
||
(5 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
− | تعيد الدالة array_keys() كل مفاتيح المصفوفة أو جزءًا منها. | + | تعيد الدالة <code>array_keys()</code> كل مفاتيح المصفوفة أو جزءًا منها. |
== الوصف == | == الوصف == | ||
سطر 9: | سطر 9: | ||
</syntaxhighlight>تعيد الدالة المفاتيح سواءً كانت أعدادًا صحيحةً أو سلاسلَ نصيةٍ. | </syntaxhighlight>تعيد الدالة المفاتيح سواءً كانت أعدادًا صحيحةً أو سلاسلَ نصيةٍ. | ||
− | إذا ما حدَّد المستخدم قيمةً للمعامل الاختياري | + | إذا ما حدَّد المستخدم قيمةً للمعامل الاختياري <code>search_value</code>، فستعيد الدالة المفاتيح المرتبطة مع هذه القيمة فقط. أو ستعيد الدالة كل مفاتيح المصفوفة فيما عدا ذلك. |
== المعاملات == | == المعاملات == | ||
− | |||
+ | === <code>array</code> === | ||
مصفوفة تحتوي على المفاتيح التي ستعيدها الدالة. | مصفوفة تحتوي على المفاتيح التي ستعيدها الدالة. | ||
− | search_value | + | === <code>search_value</code> === |
− | |||
إذا ما حدد المستخدم قيمةً لهذا المعامل، فستعيد الدالة فقط المفاتيح المرتبطة مع هذه القيمة.. | إذا ما حدد المستخدم قيمةً لهذا المعامل، فستعيد الدالة فقط المفاتيح المرتبطة مع هذه القيمة.. | ||
− | strict | + | === <code>strict</code> === |
− | + | تحدد قيمة هذا المعامل ما إذا كانت الدالة ستستعمل معامل [[PHP/comparison operators|المقارنة الصارمة]] (===) أثناء البحث. | |
− | تحدد قيمة هذا المعامل ما إذا كانت الدالة ستستعمل معامل المقارنة الصارمة (===) أثناء البحث. | ||
== القيم المعادة == | == القيم المعادة == | ||
سطر 28: | سطر 26: | ||
== أمثلة == | == أمثلة == | ||
− | المثال 1: مثال بسيط عن الدالة array_keys()<syntaxhighlight lang="php"> | + | المثال 1: مثال بسيط عن الدالة <code>array_keys()</code><syntaxhighlight lang="php"> |
+ | |||
<?php | <?php | ||
− | |||
$array = array(0 => 100, "color" => "red"); | $array = array(0 => 100, "color" => "red"); | ||
− | |||
print_r(array_keys($array)); | print_r(array_keys($array)); | ||
$array = array("blue", "red", "green", "blue", "blue"); | $array = array("blue", "red", "green", "blue", "blue"); | ||
− | |||
print_r(array_keys($array, "blue")); | print_r(array_keys($array, "blue")); | ||
$array = array("color" => array("blue", "red", "green"), | $array = array("color" => array("blue", "red", "green"), | ||
− | + | "size" => array("small", "medium", "large")); | |
− | |||
− | |||
print_r(array_keys($array)); | print_r(array_keys($array)); | ||
+ | ?> | ||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
نتيجة المثال السابق:<syntaxhighlight lang="php"> | نتيجة المثال السابق:<syntaxhighlight lang="php"> | ||
Array | Array | ||
− | |||
( | ( | ||
− | + | [0] => 0 | |
− | + | [1] => color | |
− | |||
− | |||
− | |||
) | ) | ||
− | |||
Array | Array | ||
− | |||
( | ( | ||
− | + | [0] => 0 | |
− | + | [1] => 3 | |
− | + | [2] => 4 | |
− | |||
− | |||
− | |||
− | |||
) | ) | ||
− | |||
Array | Array | ||
− | |||
( | ( | ||
+ | [0] => color | ||
+ | [1] => size | ||
+ | ) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
− | * الدالة array_values(): تعيد كل قيم المصفوفة. | + | * الدالة <code>[[PHP/array_values|array_values()]]</code>: تعيد كل قيم المصفوفة. |
− | * الدالة array_combine(): تنشئ مصفوفة جديدة عن طريق استخدام أحد المصفوفات للمفاتيح وأخرى للقيم. | + | * الدالة <code>[[PHP/array_combine|array_combine()]]</code>: تنشئ مصفوفة جديدة عن طريق استخدام أحد المصفوفات للمفاتيح وأخرى للقيم. |
− | * الدالة array_key_exists(): تتحقق من وجود أحد المفاتيح أو الفهارس بالمصفوفة. | + | * الدالة <code>[[PHP/array_key_exists|array_key_exists()]]</code>: تتحقق من وجود أحد المفاتيح أو الفهارس بالمصفوفة. |
− | * الدالة array_search(): تبحث داخل المصفوفة عن إحدى القيم وتعيد أول مفتاح مرتبط مع هذه القيمة إذا وُجد. | + | * الدالة <code>[[PHP/array_search|array_search()]]</code>: تبحث داخل المصفوفة عن إحدى القيم وتعيد أول مفتاح مرتبط مع هذه القيمة إذا وُجد. |
== مصادر == | == مصادر == |
المراجعة الحالية بتاريخ 03:49، 4 أبريل 2018
(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()
: تبحث داخل المصفوفة عن إحدى القيم وتعيد أول مفتاح مرتبط مع هذه القيمة إذا وُجد.