CKTIS / PHP
OutOfBoundsException
OutOfBoundsException deduje od RuntimeException in označuje neveljaven indeks ali ključ.
Različica: PHP 8.4; repository runtime, production runtime not attested
Sintaksa
throw new OutOfBoundsException("index missing")OutOfBoundsException deduje od RuntimeException in označuje neveljaven indeks ali ključ. Zbirka jo lahko sproži ob preverjanju meja, branje manjkajočega ključa navadnega polja v PHP 8.4 pa izda opozorilo in vrne null. Funkcija array_key_exists razlikuje shranjeni null od manjkajočega ključ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
Primeri
<?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(); }
Rezultat
NULL OutOfBoundsException index 1