中級

match式で該当する条件が無いと UnhandledMatchError になる

match式は該当するcaseが1つも無いと、switch文のように黙って何もしないのではなく、UnhandledMatchErrorという例外を投げます。想定していない値が来た場合の安全装置として働きます。

エラーメッセージの読み方

Fatal error: Uncaught UnhandledMatchError: Unhandled match case 'F' in main.php:3

main.php

ファイル名

3

行番号 — 実際にクラッシュした行

UnhandledMatchError

例外クラス — 何が起きたか。ここを検索するのが最短です

Unhandled match case 'F'

内容 — どの値が問題だったか

このエラーが出る典型パターン

 1  <?php
 2  $grade = "F";
              ^
 3  $point = match ($grade) {
 4      "A" => 4,
 5      "B" => 3,
 6  };
 7  echo $point;

 1  <?php
 2  $status = 3 ;
               ^
 3  $label = match ($status) {
 4      1 => "active",
 5      2 => "inactive",
 6  };
 7  echo $label;

 1  <?php
 2  $size = "L" ;
              ^
 3  $px = match ($size) {
 4      "S" => 12,
 5      "M" => 16,
 6  };
 7  echo $px;

よくある誤解

「matchもswitchと同じで、該当が無ければ何もせず通り抜けるはず」という思い込みは誤りです。matchは該当なしを許さない設計で、defaultに相当するものが無ければ必ず例外になります。

まとめ

match式で該当する条件が無いと UnhandledMatchError になるは中級でつまずきやすい項目です。上の3パターンを実際に手で直すと、エラーメッセージのどこを読めばよいかが掴めます。

演習をはじめる

関連するエラー

• インターフェースのメソッドを実装し忘れると Fatal error になるimplementsで宣言したインターフェースのメソッドを1つでも実装し忘れると、そのクラス自体を読み込んだ時点で致命的エラーになります。
• enumのfrom()に存在しない値を渡すと ValueError になるバックドenum（値を持つenum）のfrom()メソッドは、対応するcaseが存在しない値を渡すとValueErrorを投げます。