array_search

Searches the array for a given value and returns the first corresponding key if successful

Syntax

array_search ( mixed $needle , array $haystack [, bool $strict = FALSE ] ) : mixed

Parameters

needle

The searched value.

Note: If needle is a string, the comparison is done in a case-sensitive manner.

haystack

The array.

strict

If the third parameter strict is set to TRUE then the array_search() function will search for identical elements in the haystack. This means it will also perform a strict type comparison of the needle in the haystack, and objects must be the same instance.

Return

Returns the key for needle if it is found in the array, FALSE otherwise.

If needle is found in haystack more than once, the first matching key is returned. To return the keys for all matching values, use array_keys() with the optional search_value parameter instead.

Warning: This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on Booleans for more information. Use the identity operator (===) for testing the return value of this function.

Examples

1 · needle haystack

<?

$haystack = array("a" => "2", "b" => 2, "c" => "II");
$needle = 2;

$return = array_search($needle, $haystack);

echo $return;

?>
a

2 · strict

<?

$haystack = array("a" => "2", "b" => 2, "c" => "II");
$needle = 2;
$strict = true;

$return = array_search($needle, $haystack, $strict);

echo $return;

?>
b

array

array_change_key_case

array_chunk

array_column

array_combine

array_count_values

array_diff

array_diff_assoc

array_diff_key

array_diff_uassoc

array_diff_ukey

array_fill

array_fill_keys

array_filter

array_flip

array_intersect

array_intersect_assoc

array_intersect_key

array_intersect_uassoc

array_intersect_ukey

array_key_exists

array_key_first

array_key_last

array_keys

array_map

array_merge

array_merge_recursive

array_multisort

array_pad

array_pop

array_product

array_push

array_rand

array_reduce

array_replace

array_replace_recursive

array_reverse

array_shift

array_slice

array_splice

array_sum

array_udiff

array_udiff_assoc

array_udiff_uassoc

array_uintersect

array_uintersect_assoc

array_uintersect_uassoc

array_unique

array_unshift

array_values

array_walk

array_walk_recursive

arsort

asort

compact

count

current

end

extract

in_array

key

key_exists

krsort

ksort

list

natcasesort

natsort

next

pos

prev

range

reset

rsort

shuffle

sizeof

sort

uasort

uksort

usort

PHP

Home Menu