HOWTO · Python
Python の TypeError: must be str, not int エラーを修正
Python で mustbe str notint エラーを修正する方法を学ぶ
このページの内容
TypeError: must be str, not int は、テキストを必要とする演算に整数が渡されたことを示します。よくある原因は + による連結です。Python では両方のオペランドが文字列なら連結できますが、数値を自動的にテキストへ変換することはありません。たとえば、"Count: " + 3 はこのエラーになります。浮動小数点数、真偽値、その他の文字列以外の値でも同じ問題が起こります。
このエラーが示すのは演算のオペランドの型であり、整数の値が妥当かどうかではありません。値を変更する前に、必要なのがテキストなのか算術演算なのかを判断してください。比較、加算、その他の計算で数値のまま使う値は数値のまま保ち、表示するときにだけ書式を整えます。
Python で TypeError: must be str, not int が発生する理由
+ 演算子は、オペランドの型に応じて数値を加算したり文字列を連結したりします。一方が文字列でもう一方が整数の場合、Python は数値の桁を文字列の末尾に追加する意図なのか、数値計算をする意図なのか判断できません。変換方法を勝手に選ばず、型の不一致をエラーとして報告します。
次の最小例では、失敗する演算を捕捉してスクリプトを続行し、その後にエラーメッセージを表示します。
このセクションのコードと表示されるラベルや出力は英語のままです。
try:
result = "Count: " + 3
except TypeError as error:
message = f"{type(error).__name__}: {error}"
print(message)
TypeError: can only concatenate str (not "int") to str
意図したテキストを作るには、先に整数を変換します。修正後の式 "Count: " + str(3) は Count: 3 と評価されます。
組み込みの join() メソッドにも関連するルールがあります。入力するイテラブルの要素は文字列でなければならず、整数を自動変換することはありません。すでに文字列になっている要素を結合するときに使い、値の文字列表現が必要な場合は、意図を確認してから変換してください。
文字列を結合する前に値を確認する
テキストと別の値を結合している式を見つけ、その式の直前で各オペランドを確認します。type(value).__name__ で実行時の型が分かり、値を表示または調べると内容も確認できます。次の例を実行してください。
このセクションのコードと表示されるラベルや出力は英語のままです。
label = "Order"
number = 1923
print(f"{label} #{number}")
次の内容が表示されます。
Order #1923
型が混在する式を診断するには、結合の直前に両方のオペランドの値と型を表示します。次の例では例外を捕捉したまま、診断用の値とともにエラーメッセージを表示します。
label = "Count: "
count = 3
print(f"left={label!r} ({type(label).__name__})")
print(f"right={count!r} ({type(count).__name__})")
try:
message = label + count
except TypeError as error:
error_message = f"{type(error).__name__}: {error}"
print(error_message)
left='Count: ' (str)
right=3 (int)
TypeError: can only concatenate str (not "int") to str
left の行は、値が 'Count: ' の str を示しています。一方、right の行は、値が 3 の int を示しています。この整数が、文字列に直接連結できないオペランドです。最後の行には、発生した TypeError メッセージが表示されます。
式が失敗したときは、周囲のプログラムにある値をすべて変更するのではなく、+ の左右を両方確認してください。変数名だけでは文字列以外の値が隠れていることがあり、入力、ファイル、API から読み込んだ値の型が予想と異なる場合もあります。エラーに表示された int は整数のオペランドがあることを示しますが、式を調べれば、その値をどの変数が渡しているか特定できます。
テキストが必要なときは str() で値を変換する
レポートのラベルやメッセージなど、結果をテキストにしたい場合は str(value) を呼び出します。この関数は文字列表現を返すため、変換後の値は元の型を保持しません。表示には便利ですが、後続のコードで数値として加算、比較、その他の処理をする必要がある場合には適切な修正方法ではありません。
このセクションのコードと表示されるラベルや出力は英語のままです。
count = 1923
message = "Count: " + str(count)
print(message)
Count: 1923
リストなどのオブジェクトに対して str() を使うと、人が読むための表現が得られます。保存やデータ交換で使えることが保証されたシリアライズ形式ではありません。カスタムオブジェクトの表現は、__str__() メソッドが定義されていればその内容に基づき、定義されていなければ Python が一般的な表現方法にフォールバックします。変換後の文字列が整った文章になる、または別のプログラムで安全に解析できるとは限りません。
f文字列でテキストと値を組み合わせる
テキストと値から一つのメッセージを作るなら、f文字列が分かりやすい方法です。文字列の前に f を付け、波括弧の中に式を置きます。Python が各値を文字列用に書式化するため、通常の表示では別途 str() を呼び出す必要はありません。
このセクションのコードと表示されるラベルや出力は英語のままです。
count = 1923
price = 12.5
message = f"Count: {count}; price: {price}"
print(message)
Count: 1923; price: 12.5
波括弧内の式は書式化の一部として評価されます。読みやすさを保てる程度に式を簡潔にし、複雑な値は先に名前付き変数で計算してください。str() を使う場合と同様、書式化の結果はテキストになります。プログラムで数値としての処理が続くなら、元の数値変数を保持してください。
データに合った修正方法を選ぶ
結果がメッセージなら、str() または f文字列を使います。ラベル付きで複数の値を組み合わせる場合は f文字列が適しています。より大きな処理の一部として文字列変換が必要なら、str() を使います。値を数値として加算するなら、桁をテキストに連結するのではなく、数値として変換または検証してください。
join() を使う場合、結果を文字列のリストにしたいときに限り、各要素を明示的に変換します。ジェネレーター式を使えば、中間リストを作らずに変換できます。
このセクションのコードと表示されるラベルや出力は英語のままです。
values = [1923, 12, 5]
text = ", ".join(str(value) for value in values)
print(text)
各要素は、結合する前に表示用の文字列表現へ変換されます。要素を数値のまま扱う必要がある場合は、先に数値として計算し、最後に結果を書式化してください。こうした違いを理解すれば、型の不一致を隠すのではなく、データの目的に合った修正を選べます。