Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

UnexpectedValueException

UnexpectedValueException jest odmianą RuntimeException dla wartości niezgodnej z oczekiwaniem podczas działania, często zwróconej przez inny składnik.

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

Składnia

throw new UnexpectedValueException("invalid status")

UnexpectedValueException jest odmianą RuntimeException dla wartości niezgodnej z oczekiwaniem podczas działania, często zwróconej przez inny składnik. Poprawna składnia JSON nie gwarantuje dozwolonego statusu. Program jawnie sprawdza odczytaną wartość, więc nieznany status i uszkodzony JSON prowadzą do różnych wyjątków.

function status(string $json): string {
    $value = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (!in_array($value, ["open", "closed"], true)) {
        throw new UnexpectedValueException("invalid status");
    }
    return $value;
}
foreach (['"open"', '"other"', '{'] as $raw) {
    try { echo status($raw); } catch (UnexpectedValueException|JsonException $e) { echo get_class($e); }
    echo PHP_EOL;
}
open
UnexpectedValueException
JsonException

Przykłady

<?php
function status(string $json): string {
    $value = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
    if (!in_array($value, ["open", "closed"], true)) {
        throw new UnexpectedValueException("invalid status");
    }
    return $value;
}
foreach (['"open"', '"other"', '{'] as $raw) {
    try { echo status($raw); } catch (UnexpectedValueException|JsonException $e) { echo get_class($e); }
    echo PHP_EOL;
}

Wynik

open
UnexpectedValueException
JsonException

Źródła