Files
php-doc-ru/reference/array/constants.xml
2024-09-13 15:41:03 +03:00

312 lines
9.5 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: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: tony2001 Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="array.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants.core;
<para>
<variablelist>
<varlistentry xml:id="constant.case-lower">
<term>
<constant>CASE_LOWER</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>CASE_LOWER</constant> передают как аргумент
в функцию <function>array_change_key_case</function>, чтобы преобразовать ключи массива
в нижний регистр. Это действие по умолчанию для функции <function>array_change_key_case</function>.
Начиная с PHP 8.2.0 конвертируются только ASCII-символы.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.case-upper">
<term>
<constant>CASE_UPPER</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>CASE_UPPER</constant> передают как аргумент
в функцию <function>array_change_key_case</function>, чтобы преобразовать ключи массива
в верхний регистр. Начиная с PHP 8.2.0 конвертируются только символы в кодировке ASCII.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>Флаги порядка сортировки:
<variablelist>
<varlistentry xml:id="constant.sort-asc">
<term>
<constant>SORT_ASC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_ASC</constant> передают как аргумент
в функцию <function>array_multisort</function> для сортировки в порядке возрастания.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sort-desc">
<term>
<constant>SORT_DESC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_DESC</constant> передают как аргумент
в функцию <function>array_multisort</function> для сортировки в порядке убывания.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>Флаги типов сортировки для функций сортировки
<variablelist>
<varlistentry xml:id="constant.sort-regular">
<term>
<constant>SORT_REGULAR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_REGULAR</constant> передают как аргумент в функции сортировки
для обычного сравнения элементов массива.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sort-numeric">
<term>
<constant>SORT_NUMERIC</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_NUMERIC</constant> передают как аргумент в функции сортировки,
чтобы сравнить элементы как цифры.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sort-string">
<term>
<constant>SORT_STRING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_STRING</constant> передают как аргумент в функции сортировки,
чтобы сравнить элементы как строки.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sort-locale-string">
<term>
<constant>SORT_LOCALE_STRING</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_LOCALE_STRING</constant> передают как аргумент в функции сортировки,
чтобы сравнить элементы как строки на основе текущей локали.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sort-natural">
<term>
<constant>SORT_NATURAL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_NATURAL</constant> передают как аргумент в функции сортировки,
чтобы сравнить элементы как строки по алгоритму «естественной сортировки» (англ. natural ordering),
как это делает функция <function>natsort</function>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.sort-flag-case">
<term>
<constant>SORT_FLAG_CASE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>SORT_FLAG_CASE</constant> разрешается комбинировать
побитовым ИЛИ с константой <constant>SORT_STRING</constant>
или <constant>SORT_NATURAL</constant> для регистронезависимой сортировки строк.
Начиная с PHP 8.2.0 приведение к единому регистру выполняется только для символов в кодировке ASCII.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<para> Опции фильтрации:
<variablelist>
<varlistentry xml:id="constant.array-filter-use-key">
<term>
<constant>ARRAY_FILTER_USE_KEY</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>ARRAY_FILTER_USE_KEY</constant> передают как аргумент
в функцию <function>array_filter</function>, чтобы функция передавала в callback-функцию,
которую она вызывает, ключи массива как единственный аргумент.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.array-filter-use-both">
<term>
<constant>ARRAY_FILTER_USE_BOTH</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
Константу <constant>ARRAY_FILTER_USE_BOTH</constant> передают как аргумент
в функцию <function>array_filter</function>, чтобы функция передавала в callback-функцию,
которую она вызывает, и значение, и ключ каждого элемента массива.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
<variablelist>
<varlistentry xml:id="constant.count-normal">
<term>
<constant>COUNT_NORMAL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.count-recursive">
<term>
<constant>COUNT_RECURSIVE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-overwrite">
<term>
<constant>EXTR_OVERWRITE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-skip">
<term>
<constant>EXTR_SKIP</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-prefix-same">
<term>
<constant>EXTR_PREFIX_SAME</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-prefix-all">
<term>
<constant>EXTR_PREFIX_ALL</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-prefix-invalid">
<term>
<constant>EXTR_PREFIX_INVALID</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-prefix-if-exists">
<term>
<constant>EXTR_PREFIX_IF_EXISTS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-if-exists">
<term>
<constant>EXTR_IF_EXISTS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.extr-refs">
<term>
<constant>EXTR_REFS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- 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
-->