数组函数

PHP array_search() 函数

主题:PHP 数组参考上一页|下一页

说明

array_search() 函数在数组中搜索给定值,如果找到该值,则返回相应的键。 如果多次找到该值,则返回第一个匹配的键。

下表总结了该函数的技术细节。

返回值: 如果在数组中找到值,则返回第一个对应的键,否则返回 FALSE
变更日志: 自 PHP 5.3.0 起,如果向其传递无效参数,此函数将返回 NULL,这也适用于所有内部或内置 PHP 函数。
版本: PHP 4.0.5+

语法

array_search() 函数的基本语法如下:

array_search(value, array, strict);

下面的例子展示了 array_search() 函数的作用。

<?php
// 样本数组
$alphabets = array("a"=>"apple", "b"=>"ball", "c"=>"cat", "d"=>"dog");

// 在数组中搜索一个值
echo array_search("ball", $alphabets); // Prints: b
echo array_search("dog", $alphabets);  // Prints: d
?>

参数

array_search() 函数接受以下参数。

参数 说明
value 必填。 指定要搜索的值。
array 必填。 指定要搜索的数组。
strict 可选的。 确定在 value 搜索期间是否应使用严格比较 (===)。 可能的值为 truefalse。 默认值为 false

注意:在严格比较中(使用严格相等===运算符)值和数据类型必须相等,因此在严格比较中整数4不等于字符串"4" .


更多示例

这里有更多示例展示了 array_search() 函数的实际工作原理:

您还可以使用此函数来查找数组中某个值的索引,如下所示:

<?php
// 样本数组
$colors = array("red", "green", "blue", "yellow", "orange");

// 在数组中搜索一个值
echo array_search("red", $colors);  // Prints: 0
echo array_search("blue", $colors); // Prints: 2
?>

以下示例显示了对值的严格搜索实际上是如何工作的(注意 "")。

<?php
// 样本数组
$numbers = array(1, 2, "5", 7, 8, 5, 10, 12);

// 在数组中搜索一个值
echo array_search(5, $numbers);       // Prints: 2
echo array_search(5, $numbers, true); // Prints: 5
?>
Advertisements