Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

UnexpectedValueException

UnexpectedValueException é uma RuntimeException para um valor inesperado em execução, muitas vezes devolvido por outro componente.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

throw new UnexpectedValueException("invalid status")

UnexpectedValueException é uma RuntimeException para um valor inesperado em execução, muitas vezes devolvido por outro componente. A sintaxe JSON válida não garante um estado permitido. A verificação explícita do valor descodificado distingue um estado desconhecido de um erro de análise JSON.

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

Exemplos

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

Resultado

open
UnexpectedValueException
JsonException

Fontes