CKTIS / PHP
OutOfBoundsException
OutOfBoundsException erbt von RuntimeException und bezeichnet einen ungültigen Index oder Schlüssel.
Version: PHP 8.4; repository runtime, production runtime not attested
Syntax
throw new OutOfBoundsException("index missing")OutOfBoundsException erbt von RuntimeException und bezeichnet einen ungültigen Index oder Schlüssel. Eine Sammlung kann sie bei einer Grenzprüfung werfen, während ein fehlender gewöhnlicher Array-Schlüssel in PHP 8.4 eine Warnung und null ergibt. Die Funktion array_key_exists unterscheidet gespeichertes null vom fehlenden Schlüssel.
function fetchRow(array $rows, int $i): mixed {
if (!array_key_exists($i, $rows)) { throw new OutOfBoundsException("index " . $i); }
return $rows[$i];
}
var_dump(fetchRow([null], 0));
try { fetchRow([null], 1); }
catch (OutOfBoundsException $e) { echo get_class($e), " ", $e->getMessage(); }
NULL
OutOfBoundsException index 1
Beispiele
<?php
function fetchRow(array $rows, int $i): mixed {
if (!array_key_exists($i, $rows)) { throw new OutOfBoundsException("index " . $i); }
return $rows[$i];
}
var_dump(fetchRow([null], 0));
try { fetchRow([null], 1); }
catch (OutOfBoundsException $e) { echo get_class($e), " ", $e->getMessage(); }
Ergebnis
NULL OutOfBoundsException index 1