Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

OutOfBoundsException

OutOfBoundsException dziedziczy po RuntimeException i oznacza nieprawidłowy indeks lub klucz.

Wersja: PHP 8.4; repository runtime, production runtime not attested

Składnia

throw new OutOfBoundsException("index missing")

OutOfBoundsException dziedziczy po RuntimeException i oznacza nieprawidłowy indeks lub klucz. Kolekcja może go zgłosić po własnej kontroli granic, a zwykłe odczytanie brakującego klucza tablicy PHP 8.4 emituje ostrzeżenie i zwraca null. Funkcja array_key_exists odróżnia przechowane null od braku klucza.

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

Przykłady

<?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(); }

Wynik

NULL
OutOfBoundsException index 1

Źródła