バイナリモードとテキストモードの内部動作の違い

# テキストモード
with open("data.txt", "r", encoding="utf-8") as f:
    content = f.read()  # str 型
    print(type(content))  # <class 'str'>

# バイナリモード
with open("data.txt", "rb") as f:
    content = f.read()  # bytes 型
    print(type(content))  # <class 'bytes'>

# Windows で作成されたファイル（\r\n 改行）
# テキストモード
with open("windows.txt", "r") as f:
    content = f.read()
    print(repr(content))  # 'line1\nline2\n'（\r が消える）

# バイナリモード
with open("windows.txt", "rb") as f:
    content = f.read()
    print(repr(content))  # b'line1\r\nline2\r\n'（そのまま）

# 改行変換を無効にする
with open("data.txt", "r", newline="") as f:
    content = f.read()  # \r\n がそのまま残る

import locale

# デフォルトエンコーディングを確認
print(locale.getpreferredencoding())  # UTF-8 など

# 明示的に指定するのがベストプラクティス
with open("data.txt", "r", encoding="utf-8") as f:
    content = f.read()

# バイナリモードは buffering=0 が可能（バッファなし）
with open("data.bin", "rb", buffering=0) as f:
    pass  # OK

# テキストモードは buffering=0 不可
try:
    with open("data.txt", "r", buffering=0) as f:
        pass
except ValueError as e:
    print(e)  # can't have unbuffered text I/O

import io

# バイナリモードの内部構造
with open("data.txt", "rb") as f:
    print(type(f))  # <class '_io.BufferedReader'>
    print(type(f.raw))  # <class '_io.FileIO'>

# テキストモードの内部構造
with open("data.txt", "r") as f:
    print(type(f))  # <class '_io.TextIOWrapper'>
    print(type(f.buffer))  # <class '_io.BufferedReader'>
    print(type(f.buffer.raw))  # <class '_io.FileIO'>

# バイナリモードはバイト位置で動作
with open("data.txt", "rb") as f:
    f.seek(10)  # 10 バイト目に移動
    pos = f.tell()  # 10

# テキストモードはエンコーディング依存
with open("data.txt", "r", encoding="utf-8") as f:
    # UTF-8 では 1 文字 = 1〜4 バイト
    # seek(10) が 10 文字目とは限らない
    f.seek(0)  # 先頭への seek は常に安全
    pos = f.tell()  # 不透明な値（実装依存）