חיפוש מפתחות באמצעות 'array_search'

בעוד ש־in_array() מציינת לך אם ערך קיים במערך, לפעמים צריך לדעת בדיוק היכן הערך הזה נמצא. הפונקציה array_search() מוצאת ערך מסוים במערך ומחזירה את המפתח או את האינדקס המתאימים לו.

כך זה עובד:

<?php
$players = ["Alice", "Bob", "Charlie", "Diana"];
$position = array_search("Charlie", $players);
echo $position;  // פלט: 2
?>

הפונקציה מקבלת שני פרמטרים: הערך שאחריו מחפשים והמערך שבו מחפשים. כשהערך נמצא, array_search() מחזירה את המפתח (במערכים ממוספרים, זהו המיקום המספרי שמתחיל ב-0).

עם זאת, יש הבחנה חשובה במה שמוחזר. אם הערך נמצא, מקבלים את המפתח. אם הערך לא נמצא, הפונקציה מחזירה false:

<?php
$scores = [95, 87, 92, 78];
$found = array_search(92, $scores);    // מחזיר: 2
$notFound = array_search(100, $scores); // מחזיר: false
?>

הפונקציה הזאת שימושית במיוחד כשצריך לקבוע את המיקום או הדירוג של פריט, למשל למצוא את הדירוג של שחקן בטבלת הדירוג או לאתר את האינדקס של רכיב מסוים להמשך עיבוד.