WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen