PHP array_search() Function

PHP array_search() Function

❮ PHP Array Reference


Search an array for the value "red" and return its key:

echo array_search("red",$a);
Run example »

Definition and Usage

The array_search() function search an array for a value and returns the key.



Parameter Description
value Required. Specifies the value to search for
array Required. Specifies the array to search in
strict Optional. If this parameter is set to TRUE, then this function will search for identical elements in the array. Possible values:
  • true
  • false - Default
When set to true, the number 5 is not the same as the string 5 (See example 2)

Technical Details

Return Value: Returns the key of a value if it is found in the array, and FALSE otherwise. If the value is found in the array more than once, the first matching key is returned.
PHP Version: 4.0.5+
Changelog: This function returns NULL if invalid parameters are passed to it (this applies to all PHP functions as of 5.3.0).

As of PHP 4.2.0, this function returns FALSE on failure instead of NULL.

More Examples

Example 1

Search an array for the value 5 and return its key (notice the ""):

echo array_search(5,$a,true);
Run example »

❮ PHP Array Reference