<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 761d72245071f89a626903c9bcdc6aaff1252d54 Maintainer: shein Status: ready -->

<!-- Reviewed: no -->

<refentry xml:id="function.min" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>min</refname>

<refpurpose>Находит наименьшее значение</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>mixed</type><methodname>min</methodname>

<methodparam><type>mixed</type><parameter>value</parameter></methodparam>

<methodparam rep="repeat"><type>mixed</type><parameter>values</parameter></methodparam>

</methodsynopsis>

<simpara>Альтернативная сигнатура (не поддерживается с именованными аргументами):</simpara>

<methodsynopsis>

<type>mixed</type><methodname>min</methodname>

<methodparam><type>array</type><parameter>value_array</parameter></methodparam>

</methodsynopsis>

<para>

Функция <function>min</function> вернёт наименьшее значение массива,

если в первом и единственном аргументе передали массив. Функция <function>min</function>

вернёт наименьшее значение, если передали по крайней мере два параметра.

</para>

<note>

<para>

Функция сравнивает значения разных типов <link

linkend="language.operators.comparison">по стандартным правилами сравнения</link>.

Например, нечисловая строка (<type>string</type>) будет сравниваться с целым числом

(<type>int</type>) так, как если бы значение строки равнялось <literal>0</literal>,

но нечисловые строки (<type>string</type>) будут сравниваться в алфавитно-цифровом

порядке. Возвращаемое значение сохранит исходный тип без преобразования.

</para>

</note>

<caution>

<simpara>

При передаче аргументов разных типов соблюдают осторожность,

поскольку при сравнении разнотипных значений результат функции <function>min</function> непредсказуем.

</simpara>

</caution>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>value</parameter></term>

<listitem>

<para>

Произвольное значение, доступное <link linkend="language.operators.comparison">для сравнения</link>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>values</parameter></term>

<listitem>

<para>

Произвольные значения, доступные <link linkend="language.operators.comparison">для сравнения</link>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>value_array</parameter></term>

<listitem>

<para>

Массив значений.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Функция <function>min</function> возвращает значение параметра,

которое считает «наименьшим» по правилам сравнения.

Функция вернёт значение первого аргумента, если оценит значения разных типов

наподобие <literal>0</literal> и <literal>"abc"</literal> как равные.

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<para>

Функция <function>min</function> выбрасывает ошибку <classname>ValueError</classname>

при передаче пустого массива.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.0.0</entry>

<entry>

Функция <function>min</function> теперь выбрасывает ошибку <classname>ValueError</classname>,

если возникла ошибка;

раньше возвращалось значение &false; и выдавалась ошибка уровня <constant>E_WARNING</constant>.

</entry>

</row>

<row>

<entry>8.0.0</entry>

<entry>

При сравнении разнотипных значений функция <function>min</function> теперь

возвращает наименьшее значение по правилам сравнения, а не на основании порядка аргументов,

поскольку

<link linkend="migration80.incompatible.core.string-number-comparision">правила сравнения строк с числами</link>

изменили.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Пример получения наименьшего значения функцией <function>min</function></title>

<programlisting role="php">

<![CDATA[

<?php

echo min(2, 3, 1, 6, 7), PHP_EOL; // 1

echo min(array(2, 4, 5)), PHP_EOL; // 2

// Здесь сравнивается -1 < 0, поэтому -1 наименьшее значение

echo min('hello', -1), PHP_EOL; // -1

// При сравнении массивов разной длины функция min вернёт самый короткий

$val = max(array(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2)

var_dump($val);

// Массивы одинаковой длины сравниваются по значениям слева направо,

// поэтому в примере: 2 == 2, но 4 < 5

$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8)

var_dump($val);

// При передаче массива и значения другого типа

// массив не возвращается, поскольку сравнение считает массив бо́льшим значением

$val = min('string', array(2, 5, 7), 42); // string

var_dump($val);

// Сравнение с другими значениями произойдёт по правилу FALSE < TRUE и NULL == FALSE,

// если какой-либо аргумент равен NULL или логическому значению,

// независимо от типа аргументов

// В следующем примере -10 и 10 трактуется как TRUE

$val = min(-10, FALSE, 10); // FALSE

var_dump($val);

$val = min(-10, NULL, 10); // NULL

var_dump($val);

// Значение 0 трактуется как FALSE, поэтому 0 «меньше» TRUE

$val = min(0, TRUE); // 0

var_dump($val);

?>

]]>

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>max</function></member>

<member><function>count</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

-->