Pythonでのprint関数を使ったファイル出力方法を徹底解説！

Pythonのprint関数とは

Pythonのprint関数は、コンソールに文字列を出力するための関数です。基本的には、print(“Hello World!”)のように、引数に出力したい文字列を渡します。

print関数を使ったコンソール出力の基本

まずは、print関数を使ったコンソール出力の基本を確認してみましょう。

1
print("Hello World!")

上記のコードを実行すると、以下のようにコンソールに”Hello World!”という文字列が出力されます。

1
Hello World!

print関数を使ったファイル出力の基本

次に、print関数を使ったファイル出力の基本を確認してみましょう。

まずは、出力先となるファイルを作成します。

1
f = open("output.txt", "w")

上記のコードを実行すると、output.txtという名前のファイルが作成されます。

次に、print関数を使ってファイルに文字列を出力します。

1
print("Hello World!", file=f)

上記のコードを実行すると、output.txtというファイルに”Hello World!”という文字列が出力されます。

ファイル出力時のエンコーディング指定方法

ファイル出力時にエンコーディングを指定しない場合、デフォルトでUTF-8エンコーディングが使用されます。

しかし、出力先のファイルがUTF-8以外のエンコーディングである場合は、エンコーディングを指定する必要があります。

例えば、Shift-JISエンコーディングで出力する場合は以下のように記述します。

1
f = open("output.txt", "w", encoding="shift_jis")

print関数を使ったファイル出力の応用例

print関数を使ったファイル出力の応用例として、CSVファイルの出力を紹介します。

CSVファイルは、カンマで区切られたテキストファイルのことで、ExcelやGoogleスプレッドシートなどでよく使用されます。

以下は、CSVファイルの出力例です。

1
2
3
4
5
6
import csv
with open("output.csv", "w", newline="") as f:
    writer = csv.writer(f)
    writer.writerow(["Name", "Age", "Country"])
    writer.writerow(["Alice", 25, "Japan"])
    writer.writerow(["Bob", 30, "USA"])

上記のコードを実行すると、output.csvというファイルが作成され、以下のような内容が出力されます。

1
2
3
Name,Age,Country
Alice,25,Japan
Bob,30,USA

ファイル出力におけるエラーハンドリング

ファイル出力時には、エラーが発生する可能性があります。例えば、出力先のディレクトリが存在しない場合は、エラーが発生します。

以下は、エラーハンドリングの例です。

1
2
3
4
5
6
7
try:
    f = open("output.txt", "w")
    print("Hello World!", file=f)
except FileNotFoundError:
    print("ファイルが見つかりませんでした。")
finally:
    f.close()

上記のコードを実行すると、output.txtというファイルが作成され、”Hello World!”という文字列が出力されます。

しかし、ファイルが見つからない場合は、”ファイルが見つかりませんでした。”というエラーメッセージが出力されます。

まとめ

今回は、Pythonでのprint関数を使ったファイル出力方法について解説しました。

print関数を使ったコンソール出力の基本から、ファイル出力の基本、エンコーディング指定方法、応用例、エラーハンドリングまで、幅広く解説しました。