min

(PHP 4, PHP 5, PHP 7)

minEncontrar el valor más bajo

Descripción

min ( array $values ) : mixed
min ( mixed $value1 , mixed $value2 [, mixed $... ] ) : mixed

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(23167);  // 1
echo min(array(245)); // 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(222), array(1111)); // 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(248), array(251)); // 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(257), 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(-10FALSE10); // FALSE
$val min(-10NULL10);  // NULL

// 0, por el contrario, es tratado como FALSE, por lo que es "menor que" TRUE
$val min(0TRUE); // 0
?>

Ver también

  • max() - Encontrar el valor más alto
  • count() - Cuenta todos los elementos de un array o algo de un objeto