PythonのTypeError「not all arguments converted during string formatting」エラーの原因と解決方法

Pythonはルールに厳格な言語です。その厳格さのおかげで、プログラムが意図したとおりに動作するよう保たれています。しかし、文字列を扱っている際に「not all arguments converted during string formatting（文字列フォーマット中にすべての引数が変換されませんでした）」というエラーに遭遇することがあります。

この記事では、このエラーが発生する理由を解説し、よくある2つのシナリオを通じて、コード内でエラーを解決する方法を紹介します。

問題の概要：typeerror: not all arguments converted during string formatting

TypeErrorは、ある型の値に対して実行できない操作を行おうとしたときに発生するエラーです。この場合、エラーは文字列値に関係しています。

Pythonには文字列をフォーマットする方法がいくつか用意されており、文字列に値を挿入したり、文字列の末尾に値を連結したりできます。

最も一般的な文字列フォーマットの方法は次の2つです。

• % 演算子を使う方法（旧式）
• {} プレースホルダーと .format() 関数を組み合わせる方法

これら2つの構文を混在させて使用すると、エラーが発生します。

例1：文字列フォーマットの記法が混在しているケース

ベーカリーで販売する商品の価格を5%引き上げて計算するプログラムを書いてみましょう。

まず、ユーザーから商品名と商品価格という2つの情報を input() を使って受け取ります。

name = input("商品名を入力してください: ")
price = input("商品の価格を入力してください: ")

次に、「price」の値に1.05を掛けて、新しい価格を計算します。これが5%の値上げに相当します。

increase = round(float(price) * 1.05, 2)

round() を使って「increase」の値を小数点以下2桁に丸めます。最後に、文字列フォーマットを使って新しい価格をコンソールに出力します。

print("The new price of {} is ${}. " % name, str(increase))

このコードは「name」と「increase」の値を文字列に埋め込もうとしています。「increase」は変換前は浮動小数点数なので、文字列に結合できるよう str() で文字列に変換しています。コードを実行するとどうなるでしょうか。

Traceback (most recent call last):
  File "main.py", line 6, in <module>
    print("The new price of {} is {}" % name, str(discount))
TypeError: not all arguments converted during string formatting

コードの最終行でエラーが発生しました。

原因は、文字列フォーマットの構文が混在していたことです。{} と % の両方の演算子を使用していますが、これらはそれぞれ異なる種類の文字列フォーマットに使われるものです。

この問題を解決するには、コードの最終行を次のいずれかに置き換えます。

print("The new price of {} is ${}.".format(name, str(increase)))

print("The new price of %s is $%s." % (name, str(increase)))

1行目のコードは .format() 構文を使用しています。{} の部分が、.format() 内に指定された順序で値に置き換えられます。

2行目のコードは旧式の % 文字列フォーマットを使用しています。%s の部分が、% 演算子の後の括弧内に囲まれた値に置き換えられます。

もう一度コードを実行してみましょう。

商品名を入力してください: Babka
商品の価格を入力してください: 2.50
The new price of Babka is $2.62.

今度は引数が正しく文字列に埋め込まれました。

例2：剰余演算子（モジュロ）との混同

Pythonでは、パーセント記号（%）は剰余（モジュロ）計算と文字列フォーマットの両方に使用されます。剰余とは、割り算を行ったときの余りのことです。

パーセント記号を文字列に対して使うとフォーマットとして機能し、数値に対して使うと剰余計算として機能します。そのため、剰余計算を行いたい値が文字列として扱われていると、エラーが発生します。

数値が奇数か偶数かを判定するプログラムを見てみましょう。

number = input("数値を入力してください: ")
mod_calc = number % 2

if mod_calc == 0:
    print("この数値は偶数です。")
else:
    print("この数値は奇数です。")

まずユーザーに数値の入力を求め、次に剰余演算子を使って「number」を2で割った余りを計算します。

剰余演算の結果が0であれば if 文の中身が実行され、そうでなければ else 文の中身が実行されます。

コードを実行してみましょう。

数値を入力してください: 7
Traceback (most recent call last):
  File "main.py", line 2, in <module>
    mod_calc = number % 2
TypeError: not all arguments converted during string formatting

またもやTypeErrorです。このエラーが発生するのは、「number」が文字列だからです。input() メソッドは常に文字列を返します。剰余計算を行いたい場合は、「number」を浮動小数点数または整数に変換する必要があります。

float() 関数を使えば、「number」を浮動小数点数に変換できます。

mod_calc = float(number) % 2

もう一度コードを実行してみましょう。

数値を入力してください: 7
この数値は奇数です。

今度は正しく動作しました！

まとめ

「not all arguments converted during string formatting」エラーは、Pythonがすべての引数を文字列フォーマット処理に反映できなかったときに発生します。具体的には、文字列フォーマットの構文を混在させた場合や、文字列に対して剰余演算を行おうとした場合に起こります。

これで、あなたもプロのソフトウェアエンジニアのように、このよくあるPythonエラーを解決できるはずです！