この記事では、Pythonのopen関数を使ってソースコード内からファイルを読み書きする方法を解説します。Pythonでファイルを読み書きするには、open関数を使って生成したファイルオブジェクトを通してファイルにデータを書き込んだり、ファイルのデータを読み込んだりします。それでは、ファイルを読み書きする方法を見ていきましょう！
ファイル操作の基本
ファイルの読み書きは、以下のような手順で行われます。
-
STEP1open()関数でファイルを開く
open()関数を使ってファイルを開きます。戻り値にはファイルオブジェクトを返します。引数には、操作したいファイルのパスとモードを指定します。以下のコードは同じディレクトリ内にtest.txtというファイルを書き込み用として開きます。f = open('test.txt', 'w')モードについては後述します。
-
STEP2読み書き
先ほど書き込み用としてファイルを開いたので、生成したファイルオブジェクトのメソッドを使って、適当に文字を書き込んでみます。
f.write('適当な文字') -
STEP3ファイルを閉じる
開いたファイルは必ず閉じる必要があります。ファイルを閉じるにはファイルオブジェクトの
close()メソッドを呼び出します。f.close()
これがファイルを読み書きする基本となります。もう少しだけ詳しく見ていきましょう❗️
STEP1.ファイルを開く
ファイルを開くにはopen()関数を使います。open()関数は引数に「パス」と「モード」を受け取り、モードに対応したファイルオブジェクトを返します。
ファイルオブジェクト名 = open('パス', 'モード')オプションでエンコーディングを指定することもできます。
ファイルオブジェクト名 = open('パス', 'モード', 'エンコーディング')モード一覧
指定できるモードには、以下のようなものがあります。
| 文字 | モード |
|---|---|
| r | 読み込み用で開く(デフォルト) |
| w | 書き込み用で開く |
| x | ファイルが存在しなければ生成し、存在したらエラーとなる |
| a | 書き込み用で開く。すでにファイルが存在する場合は末尾に追加する |
| b | バイナリモードで開く |
| t | テキストモードで開く(デフォルト) |
| + | 更新用で開く |
以下のようにモードを省略すると「読み込み用」+「テキストモード」としてファイルを開きます。
f = open('パス')「書き込み用」 + 「テキストモード」でファイルを開くには、
f = open('パス', 'w')
# テキストモードを明示的に指定することもできるが必要はない
f = open('パス', 'wt')「読み込み用」 + 「バイナリモード」でファイルを開くには、
f = open('パス', 'rb')という感じで記述します。
STEP2.読み書き
生成したファイルオブジェクトからファイルを操作することができます。
指定したモードに対応したファイルオブジェクトが生成されるので、モードによって使用できるメソッドが異なります。書き込み用で開いた場合は、読み込むためのメソッドは使えず、読み込み用で開いた場合は、書き込むためのメソッドは使えません。
モード別のファイルオブジェクトの使い方は後述します。
STEP3. ファイルを閉じる
ファイルを閉じるにはclose()メソッドを呼び出します。
ファイルオブジェクト.close()この方法ではファイルを閉じ忘れてしまう可能性があるのでwith文を使った方が安全です。with文は以下のように記述します。
with open('パス', 'モード') as ファイルオブジェクト名:
# なんらかの処理with文を使うことでブロックを抜けた際に勝手にファイルを閉じてくれます。
ファイルを読み込む ‘r’
open()関数のモードに'r'を指定するか省略することで、ファイルを読み込むためのファイルオブジェクトを生成できます。
指定したパスのファイルが無ければFileNotFoundErrorが送出されます。
まとめて取得：readメソッド
read()メソッドを使うことで内容をまとめてを読み取ることができます。
with open('test.txt', 'r') as f:
data = f.read()
print(data)実行結果
one
two
three読み込むファイルが大きすぎる場合は危険なので分割して読み出しましょう。引数に整数を指定することで読み込む文字数を指定することができます。
with open('test.txt', 'r') as f:
data1 = f.read(4)
data2 = f.read(4)
data3 = f.read()
print(data1)
print(data2)
print(data3)実行結果
one
two
three改行も1文字としてカウントされる点に注意。
1行ずつ取得：readlineメソッド
readline()メソッドを使うことで1行ずつ(改行まで)読み取ることができます。引数を指定することで読み出す文字数を指定できます。
with open('test.txt', 'r') as f:
line1 = f.readline()
line2 = f.readline()
line3 = f.readline(5)
l = f.readline()
print(f'line1: {line1}')
print(f'line2: {line2}')
print(f'line3: {line3}')
print(f'l: {l}')実行結果
line1: one
line2: two
line3: three
l: for文を使うことでファイルの内容を1行ずつ取得することができます。
with open('test.txt', 'r') as f:
# ファイルの内容を1行ずつ取り出す
for line in f:
print(line)実行結果
one
two
threeファイル内の改行文字も読み込み、print()関数で出力しているので行間が余分に空いてしまっています。
リストとして取得：readlinesメソッド
readlines()メソッドを使うことで全ての行をリスト形式で読み出せます。ちなみに、ファイルオブジェクトをリストに変換することでも同様の処理が可能です。
with open('test.txt', 'r') as f:
lines = f.readlines()
# lines = list(f)でも同じ
print(lines)実行結果
['one\n', 'two\n', 'three']ファイルに書き込む ‘w’
open()関数のモードに'w'を指定することで、ファイルを書き込むためのファイルオブジェクトを生成することができます。
指定したパスのファイルが存在しない場合は新しくファイルが生成され、存在する場合は上書きされます。
文字列を書き込む：writeメソッド
write()メソッドを使うことで引数に渡された文字列を書き込むことができます。文字列型ではないデータを書き込みたい場合は、文字列型に変換する必要があります。
num = 7532
# 文字列に変換
s = str(num)
with open('test.txt', 'w') as f:
f.write(s)以下のファイルが生成されました。
リストの書き込み：writelinesメソッド
writelines()メソッドを使うことで引数に指定したリストをファイルに書き込むことができます。
l = ['いち', 'に', 'さん']
with open('test.txt', mode='w') as f:
f.writelines(l)以下のようなファイルが生成されました。
リストの文字列に改行を含めることで1行ずつ書き込むことができる。
l = ['いち\n', 'に\n', 'さん']
with open('test.txt', mode='w') as f:
f.writelines(l)
print()関数で書き込む
print()関数を使うことでもファイルに書き込むことができます。print()関数のfile引数に任意のファイルオブジェクトを指定することで出力先を変更することができます。
with open('test.txt', 'w') as f:
print('print関数による書き込み', file=f)以下のようにファイルに書き込むことができました。
ファイルの排他的な生成 ‘x’
open()関数のモードに'x'を指定することでパスで指定したファイルを生成することができます。すでに同じパスのファイルが存在する場合はエラーとなります。
このモードでは新たにファイルを生成する場合に上書きの危険性を回避することができます。ちなみに、生成されたファイルオブジェクトは書き込み用です。
with open('x.txt', 'x') as f:
f.write('排他的な生成')以下のようにファイルが生成されました。
もう一度同じコードを実行するとFileExistsErrorが送出されます。
書き込みまたは追記 ‘a’
open()関数のモードに'a'を指定することで書き込み用としてファイルを開くことができます。すでに同じパスのファイルが存在していればそのファイルの末尾に追記することができます。
試しに、同じファイルを何度も呼び出し書き込んでみます。
strings = []
# 3回文字列を入力してもらう
for i in range(3):
strings.append(input('文字を入力してください: '))
for string in strings:
# 同じファイルに書き込み
with open('strings.txt', 'a') as f:
f.write(string + '\n')実行
文字を入力してください: one
文字を入力してください: two
文字を入力してください: three以下のようなファイルが生成されました。
バイナリーモードで開く ‘b’
バイナリファイルを扱いたい場合にはバイナリーモードでファイルを開く必要があります。modeにbを付けることで、バイナリーモードとして実行することができます。
s = 'わ'
# 'わ'をbytesに変換
b = s.encode()
# 書き込み(rb = 書き込み + バイナリーモード)
with open('binary.bin', 'wb') as f:
f.write(b)
# 読み込み(rb = 読み込み + バイナリーモード)
with open('binary.bin', 'rb') as f:
b = f.read()
print(b)
# bytesからstrに変換
print(b.decode())実行結果
b'\xe3\x82\x8f'
わディレクトリ内に以下のようなバイナリーファイルが生成できました。
テキストモードで開く ‘t’
バイナリモードを指定していなければデフォルトでテキストモードでファイルを開いています。なので、いつもは省略されているだけで'w'と'wt'は等価です。
s = '書き込み'
with open('test.txt', 'wt') as f:
f.write(s)
with open('test.txt', 'rt') as f:
d = f.read()
print(d)実行結果
書き込み更新用で開く ‘+’
+は'r'、または'rb'と組み合わせることで任意の場所の文字のみを書き換えることができる。
例えば以下のようなテキストファイルがあったとします。
test.txt
abcd
123
あいうこのファイルを'r+'で書き換えてみます。
s = 'zyx'
with open('test.txt', 'r+') as f:
f.write(s)
with open('test.txt', 'r') as f:
d = f.read()
print(d)実行結果
zyxd
123
あいうabcの部分のみを書き換えることができました。
位置の移動[seekメソッド]
ファイルオブジェクトのseekメソッドを使うことで書き込む位置を移動することができます。ただし、文字単位の移動なので扱いが難しいです。
s = 'zyx'
with open('test.txt', 'r+') as f:
f.seek(5)
f.write(s)
with open('test.txt', 'r') as f:
d = f.read()
print(d)実行結果
zyxd
zyx
あいうseekメソッドで5文字目に移動したので5文字目から書き換えられました。
まとめ
この記事では、Pythonでファイルを読み書きする方法を解説しました。
ファイルを読み書きすることでセーブデータや設定ファイルなどを作ることができます。しかし、そのままファイルに書き込んでしまうと簡単に書き換えられてしまうので、暗号化などの一手間を加える必要があります。
それでは今回の内容はここまでです！ではまたどこかで〜( ・∀・)ﾉ
