Pythonのファイルオブジェクトの主な属性とメソッドを徹底解説

Pythonでは、open()関数を使ってファイルを開くと「ファイルオブジェクト」が返されます。このオブジェクトは、ファイルの読み書きや状態管理を行うための多数の属性とメソッドを持っています。本記事では、特によく使われるメソッドと属性について、具体例を交えながらわかりやすく解説します。

よく使われるファイルオブジェクトのメソッド

• close() ― 開いたファイルを閉じます。ファイル操作が終わったら必ず呼び出し、リソースを解放しましょう。

• next() ― ファイルをイテレータとして扱う際に呼び出されるメソッドです。for line in f: のようにforループでファイルを回すとき、このメソッドが繰り返し実行され、次の行を返します。ファイル末尾（EOF）に達すると StopIteration を発生させてループを終了します。なお、Python 3では __next__() という名前に変更されています。

• read([size]) ― ファイルから最大 size バイトを読み込みます。size を省略すると、ファイル全体を読み込みます。

• readline([size]) ― ファイルから1行まるごと読み込みます。size を指定すると、そのバイト数を上限として読み込みます。

• seek(offset[, whence]) ― C言語のstdioにある fseek() のように、ファイルの現在位置を設定します。第2引数 whence は省略可能で、デフォルトは 0（ファイル先頭からの絶対位置指定）です。その他に 1（現在位置からの相対移動）、2（ファイル末尾からの相対移動）が指定できます。

• tell() ― stdioの ftell() と同様に、ファイル内の現在位置（バイト単位）を返します。

• write(str) ― 指定した文字列をファイルに書き込みます。書き込んだ文字数（Python 3の場合は文字数、バイナリモードではバイト数）を返します。

• writelines(sequence) ― 文字列のシーケンス（リストやタプルなど）をまとめてファイルに書き込みます。各行末に改行は自動的に付加されないため、必要に応じて自分で \n を追加してください。

よく使われるファイルオブジェクトの属性

• closed ― ファイルオブジェクトが閉じているかどうかを示す真偽値（bool）。True ならファイルはクローズ済みです。

• encoding ― このファイルで使用されているエンコーディング（例：UTF-8）。テキストモードでのみ意味を持ちます。

• mode ― ファイルを開いたときのI/Oモード（例：'r'、'w'、'a' など）。

• name ― ファイルオブジェクトが open() によって作成された場合、そのファイル名を示します。それ以外の場合は、ファイルオブジェクトの生成元を表す何らかの文字列（例：'<stdin>'）が入ります。

使用例

以下は、これらのメソッドや属性を組み合わせた簡単な例です。

f = open('sample.txt', 'r', encoding='utf-8')

print(f.mode)       # 'r' が出力される
print(f.encoding)   # 'utf-8' が出力される
print(f.tell())     # 現在位置（0）を出力

line = f.readline() # 1行読み込む
f.seek(0)           # 先頭に戻る

text = f.read()     # 全文を読み込む
f.close()

print(f.closed)     # True が出力される

なお、Pythonでは with 文を使うのが推奨されています。with open('sample.txt', 'r') as f: と記述すれば、処理が終了した時点で自動的にファイルが閉じられるため、close() の呼び忘れを防げます。