Pythonでのファイルの読み書き：read()とwrite()メソッドの使い方

Pythonのファイルオブジェクトには、ファイル操作を簡単に行うためのさまざまなアクセスメソッドが用意されています。この記事では、read()メソッドとwrite()メソッドを使って、ファイルの読み書きを行う基本的な方法を解説します。

write()メソッドでファイルに書き込む

write()メソッドは、開いているファイルに文字列を書き込むためのメソッドです。Pythonの文字列はテキストだけでなくバイナリデータも扱えるため、画像などのデータを書き込むことも可能です。

なお、write()メソッドは文字列の末尾に自動的に改行文字（'\n'）を追加しません。改行したい場合は、文字列の中に明示的に'\n'を含める必要があります。

構文

fileObject.write(string)

引数には、開いたファイルに書き込む内容を指定します。

書き込みの例

#!/usr/bin/python
# ファイルを開く
fo = open("foo.txt", "wb")
fo.write("Python is a great language.\nYeah its great!!\n")
# 開いたファイルを閉じる
fo.close()

上記のコードを実行すると、foo.txtというファイルが作成され、指定した内容が書き込まれた後、ファイルが閉じられます。作成されたファイルを開くと、次のような内容になっています。

Python is a great language.
Yeah its great!!

read()メソッドでファイルを読み込む

read()メソッドは、開いているファイルから文字列を読み取るためのメソッドです。write()メソッドと同様に、テキストデータだけでなくバイナリデータの読み取りにも対応しています。

構文

fileObject.read([count])

引数には、開いたファイルから読み取るバイト数を指定します。このメソッドはファイルの先頭から読み取りを開始し、countを省略した場合は、可能な限り多くのデータ、つまり通常はファイルの末尾まで読み取ります。

読み込みの例

先ほど作成したfoo.txtファイルを使って、実際に読み込んでみましょう。

#!/usr/bin/python
# ファイルを開く
fo = open("foo.txt", "r+")
str = fo.read(10)
print "Read String is : ", str
# 開いたファイルを閉じる
fo.close()

このコードを実行すると、次のような結果が出力されます。

Read String is : Python is

この例では先頭から10バイト分だけを読み取っているため、「Python is」という文字列が表示されています。

補足：with文を使ったより安全なファイル操作

Python 3では、ファイルを開いた後に必ずclose()を呼び出す代わりに、with文を使うことが推奨されています。with文を使うと、処理が終了した時点やエラーが発生した場合でも、ファイルが自動的に閉じられるため、閉じ忘れによるトラブルを防げます。

# with文を使った書き込みの例
with open("foo.txt", "w") as f:
    f.write("Python is a great language.\nYeah its great!!\n")

# with文を使った読み込みの例
with open("foo.txt", "r") as f:
    str = f.read(10)
    print("Read String is : ", str)

日常的な開発では、このwith文を使った書き方を習慣にしておくと、より安全で読みやすいコードになります。