array_key_exists
(PHP 4 >= 4.0.7, PHP 5)
array_key_exists — 检查给定的键名或索引是否存在于数组中
说明
bool array_key_exists
( mixed $key
, array $search
)
array_key_exists() 在给定的 key
存在于数组中时返回 TRUE
。key
可以是任何能作为数组索引的值。array_key_exists()
也可用于对象。
<h3>参数</h3>
<p>
key
要检查的键。
search
一个数组,包含待检查的键。
</p>
<h3>返回值</h3>
<p>
成功时返回 <strong><code>TRUE</code></strong>, 或者在失败时返回 <strong><code>FALSE</code></strong>。
</p>
<h3>范例</h3>
<p>
<p><strong>Example #1 <strong>array_key_exists()</strong> 例子</strong></p>
<?php
$search_array = array('first' => 1, 'second' => 4);
if (array_key_exists('first', $search_array)) {
echo "The 'first' element is in the array";
}
?>
</p>
<p><strong>Example #2 <strong>array_key_exists()</strong> 与 isset() 的对比</strong></p>
<p>
isset() 对于数组中为 <strong><code>NULL</code></strong>
的值不会返回 <strong><code>TRUE</code></strong>,而
<strong>array_key_exists()</strong> 会。
</p>
<?php
$search_array = array('first' => null, 'second' => 4);
// returns false
isset($search_array['first']);
// returns true
array_key_exists('first', $search_array);
?>
<h3>注释</h3>
<p><strong>Note</strong>:
<p>
为了向下兼容,可以使用下列已废弃的别名:
key_exists()
</p>
</p>
<p><strong>Note</strong>:
<p>
For backward compatibility reasons, <strong>array_key_exists()</strong>
will also return <strong><code>TRUE</code></strong> if <code>key</code> is a property
defined within an object given as
<code>search</code>. This behaviour should not be relied upon,
and care should be taken to ensure that <code>search</code> is
an array.
</p>
<p>
To check whether a property exists in an object, use
property_exists().
</p>
</p>
<h3>参见</h3>
<p>
isset() - 检测变量是否设置
array_keys() - 返回数组中所有的键名
in_array() - 检查数组中是否存在某个值
property_exists() - 检查对象或类是否具有该属性
</p>