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

CKTIS / PHP

Palavra-chave match

Seleciona um resultado por identidade estrita com o valor de entrada.

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

Sintaxe

match ($subject) { $key => $result, default => $fallback }

Seleciona um resultado por identidade estrita com o valor de entrada. Só avalia o resultado do ramo correspondente, sem passar ao seguinte. Sem correspondência nem default lança UnhandledMatchError. Várias chaves podem partilhar um resultado.

function label($v){return match($v){1,2=>"int","1"=>"text"};}
echo json_encode([label(1),label("1")]),PHP_EOL;
try{label(3);}catch(UnhandledMatchError $e){echo get_class($e);}
["int","text"]
UnhandledMatchError

Exemplos

<?php
function label($v){return match($v){1,2=>"int","1"=>"text"};}
echo json_encode([label(1),label("1")]),PHP_EOL;
try{label(3);}catch(UnhandledMatchError $e){echo get_class($e);}

Resultado

["int","text"]
UnhandledMatchError

Fontes