［解決！Python］テキストファイルの読み書きまとめ：解決！Python

テキストファイルに対する読み込みと書き込み、テキストファイルを読み書き両用でオープンする方法、エンコーディングの指定や検出の方法を1ページにまとめて紹介する。

[かわさきしんじ，Deep Insider編集部]

連載目次

テキストファイルの読み書きまとめ

• テキストファイルの読み込み
• テキストファイルへの書き込み
• テキストファイルを読み書き両用でオープン
• エンコーディングを指定して、シフトJISなどのファイルを読み書きする
• テキストファイルのエンコーディングを調べて、その内容を読み込む

　ここでは本連載でこれまでに紹介してきたテキストファイルの読み書きの方法をまとめる。詳しい解説はコード例の後で紹介しているリンクを参照してほしい。

テキストファイルの読み込み

# test.txtファイルの内容
#atmark IT
#
#deep insider

# ファイルをオープンして、1行ずつその内容を読み込んで処理する
with open('test.txt') as f:
    for line in f:
        line = line.rstrip()  # 読み込んだ行の末尾には改行文字があるので削除
        print(line)
# 出力結果（4行目に空行が表示されるときとされないときがあるのを除き、以下同じ）
#atmark IT
#
#deep insider

# テキストファイルをオープンして、その内容を全て読み込み、クローズする
f = open('test.txt')  # f = open('test.txt', 'rt'):
s = f.read()  # ファイルの全内容が1つの文字列として返される
print(s)
f.close()

# with文と組み合わせると使い終わったとき（ブロック終了時）や
# 例外が発生したときにファイルが自動的にクローズされる
with open('test.txt') as f:
    s = f.read()

print(s)

# pathlibモジュールのPath.read_textメソッドを使う
from pathlib import Path

p = Path('test.txt')  # s = Path('test.txt').read_text()
s = p.read_text()  # ファイルのオープン、読み込み、クローズをまとめて実行
print(s)

# 改行を区切り文字として文字列を分割し、リストに格納
sl = s.split('\n')
print(sl)  # ['atmark IT', '', 'deep insider', '']
for line in sl:
    print(line)

# readlineメソッドを使ってテキストファイルから1行ずつ内容を読み込む
with open('test.txt') as f:
    line = f.readline()
    while line:
        line = line.rstrip()
        print(line)
        line = f.readline()

# Python 3.8以降なら代入式を使ってシンプルに書ける
with open('test.txt') as f:
    while line := f.readline():
        line = line.rstrip()
        print(line)

# テキストファイルの内容をリストに読み込む
with open('test.txt') as f:
    sl = f.readlines()

print(sl)  # ['atmark IT\n', '\n', 'deep insider\n']

# readlinesメソッドを使って各行を順次処理するループを形成
with open('test.txt') as f:
    for line in f.readlines():
        line = line.rstrip()
        print(line)

　テキストファイルの読み込みについては「テキストファイルを読み込むには」を参照のこと。

テキストファイルへの書き込み

# ファイルを書き込み用にオープンして、ファイル先頭から文字列を書き込む
with open('test.txt', 'w') as f:  # 「with open('test.txt', 'wt') as f:」と同じ
    f.write('this is a test.\n')  # 改行したければ改行文字を最後に付加
    sl = ['atmark IT\n', 'deep insider\n']
    f.writelines(sl)  # 文字列リストはwritelinesメソッドで書き込む
    x = 1
    f.write(str(x) + '\n')  # テキストファイルに書き込めるのは文字列のみ

# 上で作成した内容の確認
from pathlib import Path

print(Path('test.txt').read_text(), end='')
# 出力結果：
#this is a test.
#atmark IT
#deep insider
#1

# with文を使わない場合
f = open('test.txt', 'w')
f.write('this is a test.\n')  # 戻り値は書き込んだ文字数
f.close()

# pathlibモジュールのPathクラスが提供するwrite_textメソッドを使用
p = Path('test.txt')
p.write_text('foo\nbar\nbaz\n')

print(p.read_text(), end='')
# 出力結果：
#foo
#bar
#baz

# ファイルを追記
with open('test.txt', 'a') as f:
    f.write('deep insider\n')

print(Path('test.txt').read_text(), end='')
# 出力結果：
#foo
#bar
#baz
#deep insider

# ファイルを排他的に作成してオープン
with open('test.txt', 'x') as f:  # 既に存在しているのでFileExistsError例外
    pass

with open('test2.txt', 'x') as f:
    f.write('absolutely a new line!\n')

print(Path('test2.txt').read_text(), end='')  # absolutely a new line!

　テキストファイルへの読み込みについては「テキストファイルに書き込むには」を参照のこと。

テキストファイルを読み書き両用でオープン

with open('test.txt', 'w+') as f:  # ファイルを読み書き両用でオープン
    f.write('deep insider\n')  # ファイル先頭から書き込み
    f.seek(0)  # ファイル先頭にファイルポインタを移動
    print(f.read(), end='')  # deep insider：ファイル先頭から読み込んで表示

with open('test.txt', 'r+') as f:  # 内容を削除せずに読み書き両用でオープン
    f.write('atmark IT')  # ファイル先頭から書き込み（上書き）
    f.seek(0)  # ファイル先頭にファイルポインタを移動
    print(f.read(), end='')  # atmark ITder：ファイル先頭から読み込んで表示

with open('test.txt', 'a+') as f:
    f.write('python\n')  # ファイル末尾に書き込み
    f.seek(0)  # ファイル先頭にファイルポインタを移動
    print(f.read(), end='')  # ファイル先頭から読み込んで表示
# 出力結果：
#atmark ITder
#python

with open('test.txt', 'x+') as f:  # FileExistsError例外
    pass

with open('moretest.txt', 'x+') as f:  # OK
    f.write('atmark IT\ndeep insider\n')  # ファイル先頭から書き込み
    f.seek(0)  # ファイル先頭にファイルポインタを移動
    print(f.read(), end='')  # ファイル先頭から読み込んで表示
# 出力結果：
#atmark IT
#deep insider

モード	概要	ファイルの内容	ファイルポインタ
r+	ファイルを読み書き両用でオープンする。 指定した名前のファイルがなければFileNotFoundError例外が発生する	以前のファイルの内容を削除しない	ファイル先頭
w+	ファイルを読み書き両用でオープンまたは新規作成する	以前のファイルの内容を削除する	ファイル先頭
a+	ファイルを読み書き両用でオープンまたは新規作成する	以前のファイルの内容を削除しない	ファイル末尾
x+	ファイルを読み書き両用で排他的に新規に作成する	新規に作成	ファイル先頭
open関数のモードに'+'を付加した場合の振る舞い

　テキストファイルを読み書き両用でオープンする方法については「テキストファイルを読み書き両用にオープンするには」を参照のこと。

エンコーディングを指定して、シフトJISなどのファイルを読み書きする