PythonのNoneとは？意味と使い方をやさしく解説

# Noneの基本確認
x = None
print(x)                     # 表示してみる
print(type(x))               # 型はNoneType
print(isinstance(x, type(None)))  # isinstanceでも確認

# NoneTypeの直接生成はできない(エラーになる例としてコメント)
# type(None)()  # TypeError: cannot create 'NoneType' instances

# 代表的な値の真偽値評価
values = [None, 0, 0.0, "", [], {}, False, "text", [1]]
for v in values:
    print(repr(v), "->", bool(v))

# 値を返さない関数の戻り値はNone
def greet(name):
    # 副作用として標準出力に挨拶を表示するだけ
    print(f"Hello, {name}!")

def maybe_double(x):
    # 偶数なら2倍を返し、奇数なら何もしない(=Noneを返す)
    if x % 2 == 0:
        return x * 2
    # returnがない経路はNoneになる

res1 = greet("Alice")
res2 = maybe_double(4)
res3 = maybe_double(5)

print("res1 is None:", res1 is None)
print("res2:", res2)
print("res3 is None:", res3 is None)

# 悪い例: ミュータブルなデフォルト引数(リスト)は共有される
def append_bad(item, bucket=[]):
    bucket.append(item)
    return bucket

print(append_bad(1))
print(append_bad(2))  # 前回の1が残っている(想定外の共有)

# 良い例: Noneを未指定の印にして中で新規作成する
def append_good(item, bucket=None):
    if bucket is None:
        bucket = []  # 毎回新しいリストを生成
    bucket.append(item)
    return bucket

print(append_good(1))
print(append_good(2))  # 独立した結果になる

# 初期値としてNoneを置く例
best_score = None  # まだ見つかっていない
for score in [12, 7, 19, 3]:
    if best_score is None or score > best_score:
        best_score = score

print("best_score:", best_score)

# 辞書でのNoneとキー欠如の違い
profile = {"name": "Bob", "age": None}

print("'age' in profile:", "age" in profile)          # キーは存在する
print("profile.get('age') is None:", profile.get("age") is None)

# キーが存在しない場合
print("'email' in profile:", "email" in profile)
try:
    print(profile["email"])  # 存在しないキーはKeyError
except KeyError as e:
    print("KeyError:", e)

# Noneを除外して合計を取る
data = [10, None, 5, None, 3]
cleaned = [x for x in data if x is not None]
print(cleaned, "sum =", sum(cleaned))

x = None
print(x is None)      # True
print(x is not None)  # False

# == がオーバーロードされると想定外の挙動になりうる例
class Weird:
    def __eq__(self, other):
        # 何でもNoneと等しいと主張する異常な実装
        return other is None

w = Weird()
print("w == None:", w == None)        # True になってしまう
print("w is None:", w is None)        # 正しくはFalse

def needs_value(x):
    if x is None:
        return "value is missing"  # None専用の処理
    if not x:
        return "value is falsy (but not None)"  # 0, "", [] など
    return "value is present"

print(needs_value(None))
print(needs_value(0))
print(needs_value(""))
print(needs_value(5))

# 見つからないときNoneを返す検索
from typing import Optional

def find_user(users: dict, user_id: int) -> Optional[dict]:
    # 見つからなければNone
    return users.get(user_id)

users = {1: {"name": "Ann"}}
u = find_user(users, 2)
if u is None:
    print("not found")
else:
    print("found:", u)

# 型ヒントでOptionalを使う例
from typing import Optional

def parse_int(text: str) -> Optional[int]:
    """
    数字ならintにして返し、数字でなければNoneを返す。
    """
    return int(text) if text.isdigit() else None

value = parse_int("123")
if value is not None:           # ガードすれば以降はintとして扱える
    print(value + 1)
else:
    print("not an integer")

# Python 3.10+ の | を使う書き方
def head(items: list[int]) -> int | None:
    return items[0] if items else None

print(head([9, 8, 7]))
print(head([]) is None)