Pythonでバイナリデータをファイルに書き込む方法【初心者向け解説】

Pythonでバイナリデータをファイルに書き込む方法

「バイナリファイル」とは、内容が人間が読める文字（テキスト）で構成されていないファイルのことを指します。具体的には、JPEGやGIFなどの画像ファイル、MP3などの音声ファイル、WordやPDFといったドキュメント形式のファイルなど、さまざまな種類が含まれます。

Pythonでは、open() 関数を使ってファイルを開く際、デフォルトでは「テキストモード」で開かれます。バイナリモードでファイルを開きたい場合は、モード指定に 'b' を追加します。たとえば、読み書き両用のバイナリモードなら 'w+b' のように指定します。

サンプルコード

f = open('my_file', 'w+b')
byte_arr = [120, 3, 255, 0, 100]
binary_format = bytearray(byte_arr)
f.write(binary_format)
f.close()

コードの解説

このコードでは、まず 'w+b' モード（バイナリ書き込み・読み込みモード）で「my_file」というファイルを開いています。

次に、数値のリスト [120, 3, 255, 0, 100] を bytearray() に渡してバイト列に変換します。bytearray() を使うことで、0〜255の範囲の整数値をそのままバイトデータとして扱えるようになります。

そして f.write() メソッドを使い、このバイト列をバイナリファイルとして書き込みます。最後に f.close() でファイルを閉じれば完了です。

with文を使ったより安全な書き方

実務では、ファイルの閉じ忘れを防ぐために with 文を使うのがおすすめです。以下のように記述すると、処理が終わった時点で自動的にファイルが閉じられます。

byte_arr = [120, 3, 255, 0, 100]

with open('my_file', 'wb') as f:
    f.write(bytearray(byte_arr))

このようにPythonでは、モードに 'b' を付けるだけで簡単にバイナリデータを扱うことができます。画像や音声など、テキスト以外のデータを操作する際には必ずバイナリモードを使用しましょう。