min
(PHP 4, PHP 5, PHP 7)
min — Encontrar el valor más bajo
Descripción
Si el primer y único parámetro es un array, min() devuelve el valor más bajo de ese array. Si se proporcionan al menos dos parámetros, min() devuelve el menor de estos valores.
Nota:
Valores de diferentes tipos serán comparados utilizando las reglas de comparación estándar. Por ejemplo, un string no numérico será comparado con un integer como si fuera 0, aunque varios valores de tipo string serán comparados alfanuméricamente. El valor real devuelto será del tipo original sin ninguna conversión aplicada.
Parámetros
-
valores -
Un array que contiene los valores.
-
value1 -
Cualquier valor comparable.
-
value2 -
Cualquier valor comparable.
-
... -
Cualquier valor comparable.
Valores devueltos
min() devuelve el valor del parámetro condierado "el menor" según la comparación estándar. Si varios valores de diferentes tipos se evalúan como iguales (p.ej. 0 y 'abc'), será devuelto el primero proporcionado a la función.
Si se pasa un array vacío, se devolverá FALSE y se
emitirá un error E_WARNING.
Ejemplos
Ejemplo #1 Ejemplos de uso de min()
<?php
echo min(2, 3, 1, 6, 7); // 1
echo min(array(2, 4, 5)); // 2
// La cadena 'hola' es tratada como 0 cuando se compara con un número entero
// Ya que los dos valores son iguales, el orden en el que se proporcionan determina el resultado
echo min(0, 'hola'); // 0
echo min('hola', 0); // hola
// Aquí se compara -1 < 0, por lo que -1 es el valor menor
echo min('hola', -1); // -1
// Con varios arrays de diferentes longitudes, min devuelve el más corto
$val = min(array(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2)
// Varios arrays de la misma longitud son comparados de izquierda a derecha,
// así que en nuestro ejemplo: 2 == 2, pero 4 < 5
$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8)
// Si se pasan un array y algo que no sea un array, el array nunca es devuelto
// ya que las comparaciones tratan a los arrays como mayores que cualquier otro valor
$val = min('string', array(2, 5, 7), 42); // string
// Si un argumento es NULL o un booleano, será comparado con
// otros valores usando la regla FALSE < TRUE independientemente de los otros tipos involucrados
// En los ejemplos de abajo, -10 y 10 son tratados como TRUE en la comparación
$val = min(-10, FALSE, 10); // FALSE
$val = min(-10, NULL, 10); // NULL
// 0, por el contrario, es tratado como FALSE, por lo que es "menor que" TRUE
$val = min(0, TRUE); // 0
?>
add a note
