【Python】テキストファイル書き込み入門｜writeとprintの違いと実例集

# 基本的なテキストファイル書き込みの例

# ファイルを開く (書き込みモード, UTF-8)
f = open("example.txt", mode="w", encoding="utf-8")

# 文字列を書き込む
f.write("こんにちは、Pythonのテキスト書き込み！")

# ファイルを閉じる
f.close()

# ファイルモードの違いを確認するサンプル

# 1回目: wモードで書き込み (ファイルがなければ作成)
with open("mode_sample.txt", mode="w", encoding="utf-8") as f:
    f.write("1回目: wモードで書いた行です。\n")

# 2回目: aモードで追記
with open("mode_sample.txt", mode="a", encoding="utf-8") as f:
    f.write("2回目: aモードで追記した行です。\n")

# 3回目: xモード (既にファイルがあるためエラーになります)
try:
    with open("mode_sample.txt", mode="x", encoding="utf-8") as f:
        f.write("3回目: xモードで書いた行です。\n")
except FileExistsError:
    print("xモード: 既にファイルがあるため、FileExistsErrorになりました。")

# UTF-8で日本語を含むテキストファイルを書き込む例

with open("encoding_sample_utf8.txt", mode="w", encoding="utf-8") as f:
    f.write("UTF-8で保存した日本語のテキストです。\n")

# Windows向けにcp932(Shift_JIS系)で保存する例

with open("encoding_sample_cp932.txt", mode="w", encoding="cp932") as f:
    f.write("cp932(Shift_JIS系)で保存した日本語のテキストです。\n")

# writeメソッドの基本構文と戻り値の確認

text = "Hello"
with open("write_basic.txt", mode="w", encoding="utf-8") as f:
    # 文字列を書き込む
    written = f.write(text)
    # writeの戻り値は「書き込んだ文字数」
    print("書き込んだ文字数:", written)

# 改行を含めて書き込む例

with open("write_newline.txt", mode="w", encoding="utf-8") as f:
    f.write("1行目のテキスト\n")
    f.write("2行目のテキスト\n")
    f.write("3行目のテキスト\n")

# writelinesで複数行を書き込む例

lines = [
    "1行目のテキスト\n",
    "2行目のテキスト\n",
    "3行目のテキスト\n",
]

with open("writelines_sample.txt", mode="w", encoding="utf-8") as f:
    # リスト内の文字列を順番に書き込む (改行は自分で含めておく)
    f.writelines(lines)

# 1〜100までの数字を1行ずつファイルに書き込む例

with open("numbers.txt", mode="w", encoding="utf-8") as f:
    f.writelines(f"{i}\n" for i in range(1, 101))

# 上書き(w)と追記(a)の挙動を確認するサンプル

# 1回目: wモードで上書き(実際には新規作成)
with open("overwrite_append.txt", mode="w", encoding="utf-8") as f:
    f.write("1回目: wモードで書いた行です。\n")

# 2回目: wモードで再び開く (前回の内容は消える)
with open("overwrite_append.txt", mode="w", encoding="utf-8") as f:
    f.write("2回目: wモードで書いた行です。(1回目は消えます)\n")

# 3回目: aモードで開く (2回目の内容の下に追加される)
with open("overwrite_append.txt", mode="a", encoding="utf-8") as f:
    f.write("3回目: aモードで追記した行です。\n")

# print関数を使ってファイルに書き込む例

with open("print_basic.txt", mode="w", encoding="utf-8") as f:
    print("こんにちは、printでファイルに書き込みます。", file=f)
    print("2行目もprintで書き込みます。", file=f)

# sepとendを使ったフォーマット調整の例

with open("print_format.txt", mode="w", encoding="utf-8") as f:
    # デフォルト: sep=" ", end="\n"
    print("A", "B", "C", file=f)  # → "A B C\n"

    # カンマ区切りで出力
    print("A", "B", "C", sep=",", file=f)  # → "A,B,C\n"

    # 改行なしで出力 (endを空文字にする)
    print("行の途中まで出力...", end="", file=f)
    print("ここで改行します。", file=f)

import sys

def report(message, file=sys.stdout):
    """メッセージを指定された出力先に表示する簡易関数"""
    print(message, file=file)

# コンソールに出力
report("これは標準出力(コンソール)へのメッセージです。")

# ファイルに出力
with open("report_log.txt", mode="w", encoding="utf-8") as f:
    report("これはファイルへのメッセージです。", file=f)

import datetime

def log(message, file):
    """タイムスタンプ付きでログを1行出力する簡易関数"""
    now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
    # [時刻] メッセージ という形式で出力
    print(f"[{now}] {message}", file=file)

# ログファイルに追記していく例
with open("app.log", mode="a", encoding="utf-8") as f:
    log("アプリケーションを起動しました。", file=f)
    log("ユーザーがログインしました。", file=f)
    log("処理が完了しました。", file=f)

# INI風設定ファイルを書き出す例

config = {
    "database": {
        "host": "localhost",
        "port": 5432,
    },
    "auth": {
        "user": "admin",
        "password": "secret",
    },
}

with open("config.ini", mode="w", encoding="utf-8") as f:
    for section, params in config.items():
        # セクション行 [section]
        f.write(f"[{section}]\n")
        # key=value 形式で出力
        for key, value in params.items():
            f.write(f"{key}={value}\n")
        # セクション間に空行
        f.write("\n")

# 簡単なレポートファイルを書き出す例

data = [
    ("Alice", 90),
    ("Bob", 75),
    ("Charlie", 82),
]

with open("report.txt", mode="w", encoding="utf-8") as f:
    f.write("成績レポート\n")
    f.write("====================\n")
    f.write("名前       点数\n")
    f.write("--------------------\n")

    for name, score in data:
        # 名前を左寄せ8文字、点数を右寄せ3桁で整形
        line = f"{name:<8} {score:>3}\n"
        f.write(line)

    f.write("--------------------\n")
    avg = sum(score for _, score in data) / len(data)
    f.write(f"平均       {avg:>5.1f}\n")

# 単純にテキストファイルを書き換えるパターン

def save_text(path, text):
    """指定したパスにテキストをUTF-8で保存する関数"""
    with open(path, mode="w", encoding="utf-8") as f:
        f.write(text)

# 使用例
save_text("simple.txt", "シンプルなテキスト保存の例です。\n")

# 追記モードでログを書き込むパターン

def append_log(path, message):
    """指定したパスのログファイルに1行追記する関数"""
    with open(path, mode="a", encoding="utf-8") as f:
        print(message, file=f)

# 使用例
append_log("event.log", "ユーザーがボタンをクリックしました。")
append_log("event.log", "ウィンドウを閉じました。")

import os
import tempfile

def safe_overwrite(path, text, encoding="utf-8"):
    """一時ファイルを使って安全に上書き保存する例"""
    dir_name = os.path.dirname(path) or "."
    # 一時ファイルを同じディレクトリに作成
    fd, temp_path = tempfile.mkstemp(dir=dir_name)
    os.close(fd)  # 低レベルファイルディスクリプタを閉じる

    try:
        # 一時ファイルに書き込む
        with open(temp_path, mode="w", encoding=encoding) as f:
            f.write(text)
        # 書き込みに成功したら、上書きリネーム
        os.replace(temp_path, path)
    except Exception:
        # 失敗した場合は一時ファイルを削除しておく
        if os.path.exists(temp_path):
            os.remove(temp_path)
        # エラーを呼び出し元に伝える
        raise

# 使用例
safe_overwrite("important_config.txt", "重要な設定内容を安全に保存します。\n")