max

(PHP 4, PHP 5, PHP 7)

maxEncontrar el valor más alto

Descripción

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

Si el primer y único parámetro es un array, max() devuelve el valor más alto de ese array. Si se proporcionan al menos dos parámetros, max() devuelve el mayor de estos valores.

Nota:

Los 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 no numéricos de tipo string serán comparados alfanuméricamente. El valor real devuelto será del tipo original sin ninguna conversión aplicada.

Precaución

Tenga cuidado al pasar argumentos con valores de tipos mezclados debido a que max() puede producir resultados impredecibles.

Parámetros

values

Un array que contiene los valores.

value1

Cualquier valor comparable.

value2

Cualquier valor comparable.

...

Cualquier valor comparable.

Valores devueltos

max() devuelve el valor del parámetro considerado "el mayor" según las reglas de 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 max()

<?php
echo max(23167);  // 7
echo max(array(245)); // 5

// 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 max(0'hola');     // 0
echo max('hola'0);     // hola

// Aquí se compara -1 < 0, por lo que 'hola' es el valor mayor
echo max(-1'hola');    // hola

// Con varios arrays de diferentes longitudes, max devuelve el más largo
$val max(array(222), array(1111)); // array(1, 1, 1, 1)

// Varios arrays de la misma longitud son comparados de izquierda a derecha,
// así que en nuestro ejemplo: 2 == 2, pero 5 > 4
$val max(array(248), array(251)); // array(2, 5, 1)

// Si se pasan un array y algo que no sea un array, será devuelto el array,
// ya que las comparaciones tratan a los arrays como mayores que cualquier otro valor
$val max('cadena', array(257), 42);   // array(2, 5, 7)

// 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 max(-10FALSE); // -10

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

Ver también

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