PythonのNoneとは？意味と使い方: 基本と注意点を解説

# 変数をまだ決められないときにNoneを入れておく
user = None  # ログイン済みならユーザー情報が入る想定

print(user)          # 何も決まっていない
print(user is None)  # Noneかどうかの判定

# Noneの型名は"NoneType"
print(type(None).__name__)

# Noneは唯一のオブジェクトなので、isで同一性比較してもTrue
a = None
b = None
print(a is b)      # 同じ唯一のNoneを指している
print(a == b)      # 等価比較でもTrueだが、Noneにはisを使うのが慣例

x = None

print(bool(x))  # Falseとして扱われる

if x:
    print("真です")
else:
    print("偽です(Noneは偽)")

values = [None, 0, "", [], False, "text", [1]]
for v in values:
    print(
        f"value={repr(v):>6}, "
        f"type={type(v).__name__:>8}, "
        f"bool={bool(v)!s:>5}, "
        f"is None={v is None}"
    )

current_user = None  # まだログインしていない

if current_user is None:
    print("ログインしていません")

# ログインが完了してユーザー名が入る
current_user = "alice"

if current_user is not None:
    print(f"ログイン中のユーザー: {current_user}")

def greet(name):
    # 返り値を明示しない(=Noneが返る)
    print(f"Hello, {name}!")

ret = greet("Bob")
print("返り値:", ret)
print("ret is None:", ret is None)

# 見つかればインデックス(int)、なければNoneを返す
def find_first_even(nums):
    for i, n in enumerate(nums):
        if n % 2 == 0:
            return i
    return None  # 見つからなかった

print(find_first_even([1, 3, 5]))      # None
print(find_first_even([1, 3, 6, 7]))   # 2

idx = find_first_even([1, 3, 5])
if idx is None:
    print("偶数は見つかりませんでした")
else:
    print(f"最初の偶数の位置: {idx}")

# 悪い例: デフォルトのリストは関数定義時に1度だけ作られ、呼び出し間で共有される
def append_item_bad(item, bucket=[]):
    bucket.append(item)
    return bucket

print(append_item_bad("A"))  # 期待: ["A"]
print(append_item_bad("B"))  # 期待: ["B"] だが実際は["A", "B"]に溜まる

# 良い例: Noneをデフォルトにして、必要なときに新規作成する
def append_item_good(item, bucket=None):
    if bucket is None:
        bucket = []  # 呼び出しごとに新しいリスト
    bucket.append(item)
    return bucket

print(append_item_good("A"))          # ["A"]
print(append_item_good("B"))          # ["B"]
print(append_item_good("C", ["X"]))   # 既存のリストを渡すこともできる

class AlwaysEqual:
    # どんな相手とも等しいと答える、極端な実装
    def __eq__(self, other):
        return True

obj = AlwaysEqual()

print(obj == None)   # Trueになってしまう(等価演算子が上書きされているため)
print(obj is None)   # False(同一オブジェクトではない)

tests = [None, 0, "", [], False, 1]
for x in tests:
    print(
        f"x={repr(x):>4}, not x -> {not x}, x is None -> {x is None}"
    )

# 文字列が整数ならint、失敗したらNoneを返す
def parse_int(s: str) -> int | None:
    try:
        return int(s)
    except ValueError:
        return None

for text in ["42", "forty two"]:
    n = parse_int(text)
    if n is None:
        print(f"{text!r} は整数に変換できません")
    else:
        print(f"{text!r} -> {n} (n+1={n+1})")

s = None

# そのまま呼ぶとエラーになるが、ここでは例外を捕捉して表示
try:
    print(s.upper())
except Exception as e:
    print(type(e).__name__, ":", e)

# 安全な呼び方の一例
def safe_upper(text: str | None) -> str:
    if text is None:
        return ""  # 仕様に合わせて空文字などを返す
    return text.upper()

print("安全な結果:", safe_upper(s))
print("安全な結果:", safe_upper("hello"))

x = None

try:
    print(x + 1)
except TypeError as e:
    print(type(e).__name__, ":", e)

# ガードしてから使う
x = 0 if x is None else x
print("計算結果:", x + 1)

# バグのある実装: 負値のときに値を返していない(=None)
def discounted_price(price: float) -> float | None:
    if price < 0:
        return  # Noneが返る
    if price > 100:
        return price * 0.9
    return price

# 問題の再現
p = discounted_price(-5)
print("戻り値:", p)
try:
    print("合計:", p + 10)  # TypeError
except TypeError as e:
    print(type(e).__name__, ":", e)

# 修正版: すべての経路でfloatを返す
def discounted_price_fixed(price: float) -> float:
    if price < 0:
        return 0.0  # 仕様として0に丸めるなど、一貫した型を返す
    if price > 100:
        return price * 0.9
    return price

p2 = discounted_price_fixed(-5)
print("修正版の合計:", p2 + 10)