PHP1234|PHP修炼之路|跟着明礼馨德一起修炼PHP

【函数功能】

该函数检查某个数组中是否存在指定的值，如果存在则返回该值对应的键，如果不存在则返回 false。

【函数语法】

array_search ($needle, array $haystack, $strict = null)

【参数说明】

$needle：必需，要在数组搜索的值。
$haystack：必需，要搜索的数组。
$strict：可选，如果设置该参数为 true，则检查搜索的数据与数组的值的类型是否相同。

【演示程序】

<?php
        /**
         * array_search ($needle, array $haystack, $strict = null)
         * **/
        $array = array('明礼馨德','site_name'=>'PHP1234','site_url'=>'php1234.cn','site_auth'=>'明礼馨德');
        var_dump(array_search('PHP1234', $array));
?>

【输出结果】

string(9) "site_name"

【特别注意】

1.如果在数组中找到指定的键值，则返回对应的键名，否则返回 FALSE。
2.如果在数组中找到键值超过一次，则返回第一次找到的键值所匹配的键名。
3.PHP版本：4.0.5+。
4.如果向函数传递无效的参数，函数返回 NULL（这个适用于自 PHP 5.3.0 起的所有的 PHP 函数）。
5.自 PHP 4.2.0 起，如果搜索失败，该函数返回 FALSE，而不是 NULL。

【原版定义】

/**
 * Searches the array for a given value and returns the corresponding key if successful
 * @link http://www.php.net/manual/en/function.array-search.php
 * @param needle mixed <p>
 * The searched value.
 * </p>
 * <p>
 * If needle is a string, the comparison is done
 * in a case-sensitive manner.
 * </p>
 * @param haystack array <p>
 * The array.
 * </p>
 * @param strict bool[optional] <p>
 * 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 check the
 * types of the
 * needle in the haystack,
 * and objects must be the same instance.
 * </p>
 * @return mixed the key for needle if it is found in the
 * array, false otherwise.
 * </p>
 * <p>
 * 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.
 */

转载请注明出处：php1234.cn ,原文地址：http://www.php1234.cn/a/functions/2017/0411/212.html