Files
php-doc-ru/reference/array/functions/array-keys.xml
Andrey Gromov 551bdaae46 upd
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@345404 c90b9560-bf6c-de11-be94-00142212c4b1
2018-07-27 23:23:17 +00:00

148 lines
4.2 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ce45d942db79eb30373622ce4be83306ff641b11 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.array-keys">
<refnamediv>
<refname>array_keys</refname>
<refpurpose>Возвращает все или некоторое подмножество ключей массива</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>array_keys</methodname>
<methodparam><type>array</type><parameter>array</parameter></methodparam>
<!-- $seach_value has no default value, see <https://bugs.php.net/65904> -->
<methodparam choice="opt"><type>mixed</type><parameter>search_value</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>strict</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Функция <function>array_keys</function> возвращает числовые и строковые ключи,
содержащиеся в массиве <parameter>array</parameter>.
</para>
<para>
Если указан необязательный параметр <parameter>search_value</parameter>,
функция возвращает только ключи, совпадающие с этим параметром. В обратном
случае, функция возвращает все ключи массива <parameter>array</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>array</parameter></term>
<listitem>
<para>
Массив, содержащий возвращаемые ключи.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>search_value</parameter></term>
<listitem>
<para>
Если указано, будут возвращены только ключи, содержащие данное значение.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>strict</parameter></term>
<listitem>
<para>
Определяет использование строгой проверки на равенство (===) при поиске.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает массив со всеми ключами <parameter>array</parameter>.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>array_keys</function></title>
<programlisting role="php">
<![CDATA[
<?php
$array = array(0 => 100, "color" => "red");
print_r(array_keys($array));
$array = array("blue", "red", "green", "blue", "blue");
print_r(array_keys($array, "blue"));
$array = array("color" => array("blue", "red", "green"),
"size" => array("small", "medium", "large"));
print_r(array_keys($array));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[0] => 0
[1] => color
)
Array
(
[0] => 0
[1] => 3
[2] => 4
)
Array
(
[0] => color
[1] => size
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>array_values</function></member>
<member><function>array_combine</function></member>
<member><function>array_key_exists</function></member>
<member><function>array_search</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->