【Python】関数の戻り値を理解する(return/None/複数返す)

# 2つの数値の和を「返す」関数
def add(a, b):
    # 計算した結果をreturnで呼び出し元に渡します
    return a + b

# 戻り値を変数xに受け取り、さらに再利用できます
x = add(2, 3)
print("x =", x)
print("x * 10 =", x * 10)

# スコアに応じて評価を返す。条件ごとに早期returnで分岐を明快に
def grade(score):
    if score < 0 or score > 100:
        return "invalid"  # ここで関数が終了
    if score >= 80:
        return "A"        # ここで関数が終了
    if score >= 65:
        return "B"        # ここで関数が終了
    return "C"            # すべてに当てはまらなければ最後に返す

print(grade(92))
print(grade(-3))

def add_with_print(a, b):
    # 計算結果を「表示するだけ」
    print("add_with_print:", a + b)

def add_with_return(a, b):
    # 計算結果を「返す」
    return a + b

r1 = add_with_print(2, 3)   # 表示はされるが戻り値はNone
r2 = add_with_return(2, 3)  # 戻り値5を受け取れる

print("r1は", r1)
print("r2は", r2)
print("r2の2倍は", r2 * 2)

def greet(name):
    # これは表示するだけで、戻り値は用意していません
    print("Hello,", name)

result = greet("Alice")
print("戻り値:", result, type(result))

def maybe_even(n):
    if n % 2 != 0:
        return      # ここでNoneが返る
    return n        # 偶数ならnを返す

print(maybe_even(3))  # 奇数
print(maybe_even(4))  # 偶数

def safe_divide(a, b):
    if b == 0:
        return None  # 計算できない時はNoneを返す
    return a / b

q1 = safe_divide(10, 0)
q2 = safe_divide(10, 2)

if q1 is None:
    print("q1は計算不可")
if q2 is not None:
    print("q2 =", q2)

# 個数・合計・平均を一度に返す関数
def stats(xs):
    count = len(xs)
    total = sum(xs)
    avg = total / count if count else None
    return count, total, avg  # タプル(複数値)で返す

# 個数・合計・平均を一度に返す関数
def stats(xs):
    count = len(xs)
    total = sum(xs)
    avg = total / count if count else None
    return count, total, avg  # タプル(複数値)で返す

nums = [10, 20, 30]
n, s, avg = stats(nums)  # アンパック
print(f"個数={n}, 合計={s}, 平均={avg}")

# タプルのまま受け取る
result = stats([1, 2])
print("result =", result)

# 一部だけ使う場合(慣習的に使わない変数名は_にする)
_, total_only, _ = stats([5, 5, 5])
print("total_only =", total_only)

# 個数・合計・平均を一度に返す関数
def stats(xs):
    count = len(xs)
    total = sum(xs)
    avg = total / count if count else None
    return count, total, avg  # タプル(複数値)で返す
# 3つ返るのに2変数で受け取ろうとして失敗
try:
    a, b = stats([1])
except ValueError as e:
    print("アンパック失敗:", e)

# 余りは*で受け取る(拡張アンパック)
first, *rest = stats([1])
print("first =", first, "rest =", rest)

# そもそも1変数で受け取る
t = stats([1])
print("タプルt =", t)

# 入れ子が深い例(非推奨)
def price_with_nested(price, coupon):
    if price >= 0:
        if coupon is not None:
            price = price - coupon
            return max(price, 0)
        else:
            return price
    else:
        return 0

# ガード節で早期return(推奨)
def price_with_guard(price, coupon):
    if price < 0:
        return 0
    if coupon is None:
        return price
    return max(price - coupon, 0)

print(price_with_nested(1000, 300))
print(price_with_guard(1000, 300))

def demo():
    print("start")
    return 123
    print("ここには到達しません")  # 実行されない

print(demo())

# 悪い例: 戻り値の型がバラバラ
def find_user_age(name):
    if name == "Alice":
        return 20            # int
    if name == "Bob":
        return "unknown"     # str(型が違う)
    return None              # None(さらに違う)

for n in ["Alice", "Bob", "Carol"]:
    age = find_user_age(n)
    print(n, "=>", age, type(age))

# 良い例: 未知はNone(=見つからない)に統一
def find_user_age2(name):
    data = {"Alice": 20}
    return data.get(name)  # 未登録はNone

for n in ["Alice", "Bob", "Carol"]:
    age = find_user_age2(n)
    if age is None:
        print(n, "=> age不明")
    else:
        print(n, "=>", age)

# 失敗時にNoneを返す
def to_int(text):
    try:
        return int(text)
    except ValueError:
        return None

cases = ["42", "3.14", "abc"]
for s in cases:
    v = to_int(s)
    if v is None:
        print(f"{s!r} は整数に変換できません")
    else:
        print(f"{s!r} -> {v} (type={type(v).__name__})")

# (成功フラグ, 値)で返す
def to_int2(text):
    try:
        return True, int(text)
    except ValueError:
        return False, None

ok, value = to_int2("100")
print("ok=", ok, "value=", value)
ok, value = to_int2("oops")
print("ok=", ok, "value=", value)