CKTIS / PHP
OutOfBoundsException
OutOfBoundsException dedí od RuntimeException a označuje neplatný index či kľúč.
Verzia: PHP 8.4; repository runtime, production runtime not attested
Syntax
throw new OutOfBoundsException("index missing")OutOfBoundsException dedí od RuntimeException a označuje neplatný index či kľúč. Kolekcia ju môže vyvolať po kontrole hraníc, kým čítanie chýbajúceho kľúča bežného poľa v PHP 8.4 vydá varovanie a vráti null. Funkcia array_key_exists odlíši uložené null od chýbajúceho kľúča.
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
Príklady
<?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(); }
Výsledok
NULL OutOfBoundsException index 1