Pythonのmatch-case文を使いこなす：可読性を高めるパターンマッチングの実践テクニック

def check_status(code):
    # status_codeの値に応じて分岐
    match code:
        case 200:
            return "OK"
        case 404:
            return "Not Found"
        case 500:
            return "Internal Server Error"
        case _:
            return "Unknown Code"

# 関数の実行
print(check_status(200))
print(check_status(404))
print(check_status(999))

OK
Not Found
Unknown Code

command = "quit"

match command:
    case "start":
        print("システムを開始します")
    case "stop":
        print("システムを停止します")
    case "quit":
        print("プログラムを終了します")

プログラムを終了します

def get_category(ext):
    match ext:
        case "jpg" | "jpeg" | "png" | "gif":
            return "Image"
        case "mp4" | "mkv" | "avi":
            return "Video"
        case _:
            return "Other"

print(get_category("jpeg"))
print(get_category("mp4"))

Image
Video

def process_data(data):
    match data:
        # 要素が1つだけの場合
        case [value]:
            print(f"単一データを受信: {value}")
        # 最初の要素が "SET" で、その後に2つの要素が続く場合
        case ["SET", key, val]:
            print(f"設定変更: {key} を {val} に更新")
        # 最初の要素が "GET" で、その後に1つの要素が続く場合
        case ["GET", key]:
            print(f"データ取得: {key}")
        case _:
            print("不正なデータフォーマットです")

process_data(["SET", "admin", "enabled"])
process_data(["GET", "user_id"])
process_data([100])

設定変更: admin を enabled に更新
データ取得: user_id
単一データを受信: 100

def authorize(user_info):
    match user_info:
        # roleがadminであることを確認し、nameを変数として取得
        case {"role": "admin", "name": name}:
            return f"管理者 {name} としてログインしました"
        # roleがuserであることを確認
        case {"role": "user", "name": name}:
            return f"一般ユーザー {name} としてログインしました"
        case _:
            return "アクセス権限がありません"

print(authorize({"role": "admin", "name": "田中", "id": 1}))
print(authorize({"role": "user", "name": "佐藤"}))

管理者 田中 としてログインしました
一般ユーザー 佐藤 としてログインしました

class Point:
    def __init__(self, x, y):
        self.x = x
        self.y = y

def locate_point(p):
    match p:
        case Point(x=0, y=0):
            print("原点に位置しています")
        case Point(x=x, y=0):
            print(f"X軸上の {x} に位置しています")
        case Point(x=0, y=y):
            print(f"Y軸上の {y} に位置しています")
        case Point(x=x, y=y):
            print(f"座標 ({x}, {y}) に位置しています")
        case _:
            print("ポイントではありません")

locate_point(Point(0, 5))
locate_point(Point(10, 20))

Y軸上の 5 に位置しています
座標 (10, 20) に位置しています

class User:
    __match_args__ = ("name", "age")
    def __init__(self, name, age):
        self.name = name
        self.age = age

def greet_user(u):
    match u:
        # __match_args__により、順番通りに変数へ代入される
        case User("Alice", age):
            print(f"アリスさん、あなたは {age} 歳ですね")
        case User(name, age):
            print(f"こんにちは {name} さん (年齢: {age})")

greet_user(User("Alice", 25))
greet_user(User("Bob", 30))

アリスさん、あなたは 25 歳ですね
こんにちは Bob さん (年齢: 30)

def validate_age(data):
    match data:
        # パターンに一致し、かつ if 条件が真の場合のみ実行
        case {"age": age} if age < 0:
            print("エラー: 年齢が負の値です")
        case {"age": age} if age >= 20:
            print(f"{age}歳は成人です")
        case {"age": age}:
            print(f"{age}歳は未成年です")

validate_age({"age": 25})
validate_age({"age": -5})

25歳は成人です
エラー: 年齢が負の値です

def process_message(msg):
    match msg:
        case {"type": "error", "code": c} as full_msg:
            print(f"エラーコード {c} を受信しました。フルデータ: {full_msg}")
        case {"type": "info"}:
            print("情報メッセージです")

process_message({"type": "error", "code": 500, "timestamp": "2026-05-01"})

エラーコード 500 を受信しました。フルデータ: {'type': 'error', 'code': 500, 'timestamp': '2026-05-01'}

def handle_api_response(response):
    match response:
        case {"status": "success", "data": {"items": list(items), "count": n}}:
            print(f"{n}件のアイテムを正常に取得しました")
            for item in items:
                print(f"- {item}")
        case {"status": "error", "message": msg}:
            print(f"エラーが発生しました: {msg}")
        case _:
            print("予期しないレスポンス形式です")

# 正常系
handle_api_response({
    "status": "success",
    "data": {"items": ["Apple", "Banana"], "count": 2}
})

2件のアイテムを正常に取得しました
- Apple
- Banana

def cli_router(argv):
    match argv:
        case ["python", "main.py", "run", "--debug"]:
            print("デバッグモードで実行中...")
        case ["python", "main.py", "run"]:
            print("通常モードで実行中...")
        case ["python", "main.py", "export", filename]:
            print(f"ファイルを {filename} に書き出します")
        case _:
            print("使用法: python main.py [run|export] [options]")

cli_router(["python", "main.py", "run", "--debug"])
cli_router(["python", "main.py", "export", "report.csv"])

デバッグモードで実行中...
ファイルを report.csv に書き出します