Bestimmt den Minimalwert

Beschreibung

min(mixed $value, mixed ...$values): mixed

Alternative Signatur (benannte Parameter werden nicht unterstützt):

min(array $value_array): mixed

Ist der erste und einzige Parameter ein Array, gibt min() den niedrigsten Wert dieses Arrays zurück. Werden mindestens zwei Parameter übergeben, gibt min() den kleinsten dieser Werte zurück.

Hinweis:
Werte unterschiedlichen Typs werden unter Verwendung der Standard-Vergleichsregeln verglichen. Zum Beispiel wird ein nichtnumerischer string mit einem int verglichen, als ob er 0 wäre, aber mehrere nichtnumerische string-Werte werden alphanumerisch verglichen. Der tatsächlich zurückgegebene Wert ist vom ursprünglichen Typ ohne angewandte Umwandlung.

Achtung

Vorsicht ist geboten, wenn Argumente verschiedenen Typs übergeben werden, da min() in diesem Fall unvorhersehbare Ergebnisse liefert.

Parameter-Liste

value: Ein vergleichbarer Wert.
values: Jegliche vergleichbaren Werte.
value_array: Ein Array, das Werte enthält.

Rückgabewerte

min() gibt den gemäß den Standard-Vergleichen als "kleinsten" angesehenen Parameter-Wert zurück. Evaluieren mehrere Werte unterschiedlichen Typs als gleich (z. B. 0 und 'abc'), wird der zuerst übergebene zurückgegeben.

Fehler/Exceptions

Wird ein leeres Array übergeben, löst min() einen ValueError aus.

Changelog

Version	Beschreibung
8.0.0	min() löst bei einem Fehler nun einen ValueError aus; vorher wurde `false` zurückgegeben und ein Fehler der Stufe `E_WARNING` ausgegeben.
8.0.0	Die Art und Weise, wie Zeichenketten und Zahlen verglichen werden, wurde geändert, sodass min() in solchen Fällen nicht mehr je nach Reihenfolge der Argumente unterschiedliche Werte zurückgibt.

Beispiele

Beispiel #1 Beispiel für die Verwendung von min()

<?php
echo min(2, 3, 1, 6, 7);  // 1
echo min(array(2, 4, 5)); // 2

// Hier vergleichen wir -1 < 0, so dass -1 der kleinste Wert ist
echo min('hello', -1);    // -1

// Bei mehreren Arrays unterschiedlicher Länge, gibt min das kürzeste zurück
$val = min(array(2, 2, 2), array(1, 1, 1, 1)); // array(2, 2, 2)

// Mehrere Arrays gleicher Länge werden von links nach rechts verglichen,
// daher ist in unserem Beispiel 2 == 2, aber 4 < 5
$val = min(array(2, 4, 8), array(2, 5, 1)); // array(2, 4, 8)

// Sind ein Array und ein Nicht-Array-Parameter gegeben, wird nie das Array zurückgegeben,
// da Vergleiche Arrays als größer behandeln als alle anderen Werte
$val = min('string', array(2, 5, 7), 42);   // string

// Ist ein Argument NULL oder ein boolescher Wert, wird es mit anderen Werten
// unter Verwendung der Regeln FALSE < TRUE und NULL == FALSE verglichen, ohne Rücksicht auf die anderen beteiligten Typen
// In den folgenden Beispielen wird -10 im Vergleich wie TRUE behandelt
$val = min(-10, FALSE, 10); // FALSE
$val = min(-10, NULL, 10);  // NULL

// Andererseits wird 0 wie FALSE behandelt, so dass es "kleiner" ist als TRUE
$val = min(0, TRUE); // 0
?>

Siehe auch

max() - Bestimmt den Maximalwert
count() - Zählt alle Elemente eines Arrays oder eines Countable-Objekts