Pythonの型変換入門|int・float・strの使い方とValueError・TypeErrorの直し方
Python で input() から受け取った値に 1 を足そうとしたら TypeError、”3.14″ を int() にしたら ValueError……。どちらも「型(データの種類)」が原因のエラーです。Python は文字列と数値を自動では変換しないので、int()・float()・str() を使って自分で変換する必要があります。
この記事では、型変換の基本と、変換で出るエラーの読み方・直し方を、Python 3.12.6(Windows 11)で実際に実行した結果つきで説明します。コードは sample.py などの名前で保存し、PowerShell で py sample.py と実行してください。
この記事で分かること:
- input() の値が文字列である理由と、数値に変換する方法
- int() が受け付ける文字列・受け付けない文字列(”3.14″・”1,000″・空文字など)
- int(3.99) が 3、int(-3.99) が -3 になる「0 の方向への切り捨て」
- int(“ff”, 16) などの基数指定と、hex()・format() での逆変換
- ValueError・TypeError・OverflowError の違いと、安全に変換する関数の書き方
型変換が必要になる場面:input() は文字列を返す
いちばんよく出会うのが input() です。次のコードを実行し、20 と入力して Enter キーを押してみます。
age = input("年齢を入力:")
print(type(age))
print(age + 1)
年齢を入力:20
<class 'str'>
Traceback (most recent call last):
……
print(age + 1)
~~~~^~~
TypeError: can only concatenate str (not "int") to str
type() で調べると、入力した 20 は str(文字列)です。input() はキーボードから打った文字をそのまま文字列で返すためです。文字列の “20” と整数の 1 は + でつなげないので、「str には str しか連結できません(int ではなく)」という TypeError になりました。
int() で整数に変換してから足せば、期待どおり 21 になります。
age = int(input("年齢を入力:"))
print(age + 1)
年齢を入力:20
21
input() だけでなく、ファイルや CSV から読んだ値、コマンドライン引数(sys.argv)、環境変数(os.environ)も、すべて文字列で届きます。外から来た値は「まず文字列」と覚えておくと、エラーの原因に早く気づけます。
int・float・str の基本の変換
変換したい型の名前を関数のように呼ぶと、その型の値が返ります。
print(int("42") + 1)
print(float("3.14") * 2)
print(str(42) + "歳")
print(type(int("42")), type(float("3.14")), type(str(42)))
43
6.28
42歳
<class 'int'> <class 'float'> <class 'str'>

元の値は変わらず、変換した新しい値が返る点に注意してください。int(age) と書いただけでは age は文字列のままで、age = int(age) と代入して初めて整数になります。
文字列を int にする:通るもの・通らないもの
前後の空白・符号・先頭の 0・アンダースコアは OK
print(int(" 42\n"))
print(int("-15"))
print(int("007"))
print(int("1_000"))
print(int("12"))
42
-15
7
1000
12
公式ドキュメントのとおり、前後の空白や改行、先頭の + / -、先頭の 0、数字の間の 1 つのアンダースコア(_)は受け付けます。ファイルから読んだ行の末尾の改行も、int() ならそのままで構いません。
意外なのが最後の行で、全角数字の「12」も 12 に変換されます。フォームの入力を半角数字だけに限りたいときは、後の「安全に変換する関数」の章のように、変換の前に確かめる必要があります。
小数・カンマ・空文字は ValueError
for s in ["3.14", "1,000", "", "abc", "0x1A"]:
try:
print(int(s))
except ValueError as e:
print("ValueError:", e)
ValueError: invalid literal for int() with base 10: '3.14'
ValueError: invalid literal for int() with base 10: '1,000'
ValueError: invalid literal for int() with base 10: ''
ValueError: invalid literal for int() with base 10: 'abc'
ValueError: invalid literal for int() with base 10: '0x1A'
メッセージは「10 進数(base 10)の int としては無効な文字列です」という意味で、最後に実際に渡された文字列が表示されます。” と表示されたら空文字(未入力や空のセル)、’3.14′ なら小数、’1,000′ なら桁区切りのカンマが原因だと分かります。’0x1A’ のような 16 進数の表記は、このあと説明する基数の指定が必要です。
カンマ区切りは int("1,000".replace(",", "")) のように取り除けば 1000 になります。
None やリストは TypeError
print(int(None))
Traceback (most recent call last):
……
TypeError: int() argument must be a string, a bytes-like object or a real number, not 'NoneType'
文字列だけど中身がおかしいときは ValueError、そもそも変換できない型(None・リスト・辞書など)を渡したときは TypeError です。辞書の get() で値がなかったときや、関数が何も返さなかったとき(None)によく起きます。
小数の文字列・float を int にする
“3.14” は float を経由する
print(int(float("3.14")))
print(int("1,000".replace(",", "")))
print(int(float("12345678901234567890")))
3
1000
12345678901234567168
“3.14” のような小数の文字列は、いったん float() にしてから int() にします。ただし 3 行目のように、桁の多い数を float に通すと値が変わります。float が正確に表せる整数はおよそ 16 桁までだからです(仕組みは「浮動小数点数の誤差とは?0.1+0.2が0.3にならない理由と対処法」で解説しています)。大きな数や金額は、float を通さずに Decimal を使います(後の章で紹介します)。
int() は「0 の方向へ切り捨て」、四捨五入ではない
import math
print(int(3.99), int(-3.99))
print(math.floor(-3.99), math.ceil(3.01))
print(round(3.99), round(2.5), round(3.5))
3 -3
-4 4
4 2 4
| 書き方 | 動き | 3.99 → | -3.99 → |
|---|---|---|---|
| int(x) | 0 の方向へ切り捨て(小数部分を捨てる) | 3 | -3 |
| math.floor(x) | 小さいほうへ(数直線の左へ) | 3 | -4 |
| math.ceil(x) | 大きいほうへ(数直線の右へ) | 4 | -3 |
| round(x) | 近い整数へ。ちょうど半分なら偶数へ | 4 | -4 |
公式ドキュメントにも、float に対する int() は「0 の方向へ切り捨てる」と書かれています。プラスの数では切り捨てと同じですが、マイナスの数では math.floor() と結果が違うので注意してください(表の floor・ceil・round の -3.99 の値も実行して確かめました)。また round(2.5) は 3 ではなく 2 です。round() はちょうど半分のとき偶数のほうへ丸めるためで、四捨五入したいときの方法は「PythonのDecimalでお金を正確に計算する方法」で紹介しています。
int(x, 16):2 進数・16 進数の文字列を変換する
第 2 引数で基数を指定する
int() の第 2 引数に基数(何進数か)を渡すと、その進数の文字列として読みます。指定できるのは 2〜36 と 0 です。
print(int("ff", 16))
print(int("FF", 16))
print(int("0xff", 16))
print(int("1010", 2))
print(int("777", 8))
print(int("0b1010", 0), int("0o17", 0), int("0x1f", 0))
255
255
255
10
511
10 15 31
- 16 進数の a〜f は大文字でも小文字でも読めます
- 基数 16 なら先頭の 0x を付けたままでも読めます(基数 2 の 0b、基数 8 の 0o も同じ)
- 基数 0 を指定すると、0b・0o・0x の接頭辞を見て進数を自動で決めます(接頭辞がなければ 10 進数)。設定ファイルなどに 10 進数と 16 進数が混ざっているときに便利です
変換結果が合っているか確かめたいときは、「基数変換ツール」に ff や 1010 を入れると、2・8・10・16 進数を一度に比べられます。2 進数・16 進数そのものの考え方は「2進数・16進数の基本」で解説しています。
基数を指定したときのエラー
for args in [("g", 16), ("102", 2), ("010", 0)]:
try:
print(int(*args))
except ValueError as e:
print("ValueError:", e)
ValueError: invalid literal for int() with base 16: 'g'
ValueError: invalid literal for int() with base 2: '102'
ValueError: invalid literal for int() with base 0: '010'
16 進数に g はなく、2 進数に 2 はないので ValueError です。メッセージの base の値で、何進数として読もうとしたかが分かります。3 つ目は基数 0 の注意点で、公式ドキュメントのとおり基数 0 では先頭に 0 を付けた “010” が使えません(int(“010”) や int(“010”, 8) は使えます)。
もう 1 つよくあるのが、すでに数値になっているものに基数を付けるミスです。
print(int(255, 16))
Traceback (most recent call last):
……
TypeError: int() can't convert non-string with explicit base
「基数を指定したときは文字列以外を変換できません」という意味です。基数は「文字列をどう読むか」の指定なので、数値の 255 を 16 進数の文字列にしたいなら、次の hex() や format() を使います。
逆向き:数値を 2 進数・16 進数の文字列にする
print(bin(10), oct(15), hex(255))
print(format(10, "b"), format(5, "08b"), format(255, "X"))
print(f"{255:#06x}")
print(int(hex(255), 16))
0b1010 0o17 0xff
1010 00000101 FF
0x00ff
255
- bin()・oct()・hex() は 0b・0o・0x の接頭辞付きの文字列を返します
- format() や f 文字列なら、接頭辞なし(”b”・”x”・”X”)、0 埋めの桁数(”08b”)、接頭辞付きで全体 6 桁(”#06x”)などを指定できます。書式の詳しい説明は「Pythonのf文字列(f-string)の使い方」にあります
- hex() の結果は int(…, 16) でそのまま元に戻せます
マイナスの数と 2 の補数
print(hex(-1))
print(format(-1 & 0xFF, "08b"))
v = int("ff", 16)
if v >= 0x80:
v -= 0x100
print(v)
-0x1
11111111
-1
Python の整数には桁数の上限がないため、hex(-1) は 2 の補数(コンピューターでマイナスを表す方法)ではなく、単に「-0x1」になります。8 ビットの 2 の補数で見たいときは、-1 & 0xFF で下位 8 ビットを取り出します。反対に、機器から受け取った 1 バイトの “ff” を符号付きの数として読むには、0x80 以上なら 0x100(256)を引きます。2 の補数の求め方と、ビット数ごとの表せる範囲は「基数変換ツール」のページ(マイナスの数を 2 の補数で表示する機能もあります)、& の使い方は「ビット演算の基本と実用例」で解説しています。
float():小数への変換と OverflowError
print(float("1e3"))
print(float(" 2.5 "))
print(float("inf"), float("-Infinity"), float("nan"))
print(float("1e400"))
print(float(10))
1000.0
2.5
inf -inf nan
inf
10.0
float() は “1e3″(1 × 103)のような指数表記や前後の空白も読めます。注意したいのが 3〜4 行目で、“inf”・”nan” という文字列も数値として通ってしまいます(公式ドキュメントのとおり大文字・小文字も区別しません)。また “1e400” のように大きすぎる文字列は、エラーにならずに inf(無限大)になりました。入力チェックに float() を使うときは、math.isfinite(x) で inf・nan でないことも確かめると安全です。
for f in [lambda: float("1,5"), lambda: float(10**400), lambda: int(float("inf")), lambda: int(float("nan"))]:
try:
print(f())
except (ValueError, OverflowError) as e:
print(type(e).__name__ + ":", e)
ValueError: could not convert string to float: '1,5'
OverflowError: int too large to convert to float
OverflowError: cannot convert float infinity to integer
ValueError: cannot convert float NaN to integer
- 小数点にカンマを使う “1,5” は ValueError です。float() のメッセージは「文字列を float に変換できません」と、int() とは言い回しが違います
- 10 の 400 乗のような大きすぎる整数を float にすると OverflowError(範囲を超えたエラー)です。文字列の “1e400” が inf になったのとは動きが違います
- inf を int にすると OverflowError、nan を int にすると ValueError です
str():数値を文字列にする
“年齢:” + 20 の TypeError
age = 20
print("年齢:" + age)
Traceback (most recent call last):
……
print("年齢:" + age)
~~~~~~~~~^~~~~
TypeError: can only concatenate str (not "int") to str
最初の input() の例と同じエラーですが、今度は逆で「文字列に数値をつなげたい」場面です。順番を逆にした 20 + "歳" では TypeError: unsupported operand type(s) for +: 'int' and 'str' と、メッセージが変わります(「int と str の + は使えません」という意味)。どちらも、str() で文字列にするか、f 文字列を使えば解決します。
age = 20
print("年齢:" + str(age))
print(f"年齢:{age}")
print(str(0.1 + 0.2), str(100.0), str(1e16), str(0.00001))
print(str(None), str(True))
年齢:20
年齢:20
0.30000000000000004 100.0 1e+16 1e-05
None True
f 文字列は中で自動的に文字列にしてくれるので、ふつうはこちらが読みやすく便利です。float を str() にすると、0.1 + 0.2 の誤差がそのまま出たり、1e16 や 0.00001 が指数表記(1e+16・1e-05)になったりします。画面に出す桁数を決めたいときは、f"{x:.2f}" のように書式を指定します。また str(None) は “None” という文字列になるので、None をうっかり画面やファイルに書き出していないか注意しましょう。
bytes は str() ではなく decode() で
data = "abc".encode()
print(str(data))
print(data.decode())
b'abc'
abc
通信やファイルから読んだ bytes(バイト列)を str() にすると、”b’abc'” という表示用の文字列になってしまいます。中身の文字を取り出すには decode() を使います。decode() は既定で UTF-8 として読むので、Shift_JIS のデータなら decode("cp932") のように文字コードを指定します(文字コードの違いは「文字コードとは?UTF-8・Shift_JIS・EUC-JPの違い」で解説しています)。
bool():”False” という文字列は True になる
print(bool("False"), bool("0"), bool(" "), bool(""))
True True True False
bool() は、文字列の場合空かどうかだけを見ます。中身が “False” でも “0” でも、空でなければ True です。設定ファイルや環境変数の “false” を真偽値にしたいときは、bool() ではなく、自分で文字を比べる関数を作ります。
def to_bool(text):
t = text.strip().lower()
if t in ("true", "1", "yes", "on"):
return True
if t in ("false", "0", "no", "off", ""):
return False
raise ValueError(f"真偽値として読めません: {text!r}")
print(to_bool("False"), to_bool(" TRUE "), to_bool("0"))
False True False
どの文字を True とみなすかは、扱うデータに合わせて決めてください。決めた以外の文字は ValueError にしておくと、”ture” のような打ち間違いに気づけます。
自動で変わる型:計算の結果の型
文字列と数値は自動で変換されませんが、数値どうしの計算では型が自動で決まります。
print(1 + 2.0)
print(7 / 2, 6 / 3)
print(7 // 2, -7 // 2)
print(True + 1)
print(10 == 10.0)
print("3" * 3)
3.0
3.5 2.0
3 -4
2
True
333
- int と float を計算すると float になります(1 + 2.0 は 3.0)
/の割り算は、割り切れても必ず floatです(6 / 3 は 2.0)。リストの添字などに使うと TypeError になるので、整数がほしいときは//を使います//は小さいほうへ切り捨てるので、-7 // 2 は -3 ではなく -4 です(int(-3.5) の -3 とは違います)- True は 1、False は 0 として計算されます
- “3” * 3 はエラーにならず、文字列を 3 回くり返した “333” になります。数値のつもりで文字列のまま掛け算すると、エラーが出ないまま間違った結果になります
安全に変換する関数を作る
try / except で変換できないときの値を決める
ユーザーの入力や CSV のように、変換できない値が混ざるかもしれないときは、try / except で ValueError と TypeError を受け止めます。
def to_int(text, default=None):
"""整数に変換できなければ default を返す"""
try:
return int(text)
except (ValueError, TypeError):
return default
for v in ["42", " 7 ", "3.14", "", None, "12"]:
print(repr(v), "->", to_int(v))
'42' -> 42
' 7 ' -> 7
'3.14' -> None
'' -> None
None -> None
'12' -> 12
except には、起きると分かっている例外だけを書きます。except: や except Exception: とすると、変数名の打ち間違い(NameError)まで黙って None になり、バグに気づけなくなります。例外処理の書き方は「Pythonの例外処理入門」で詳しく解説しています。
isdigit() で事前に調べるときの落とし穴
変換の前に文字列のメソッドで調べる方法もありますが、思ったとおりに判定されないことがあります。
for s in ["12", "12", "-5", "3.5"]:
print(repr(s), s.isdecimal(), s.isascii() and s.isdecimal())
print("²".isdigit(), "²".isdecimal())
'12' True True
'12' True False
'-5' False False
'3.5' False False
True False
- “-5” のマイナスや “3.5” の小数点は数字ではないので、isdecimal() は False です。マイナスの数も受け付けたいなら、try / except で int() に任せるほうが確実です
- 全角の “12” も isdecimal() は True です。半角数字だけに限りたいときは
s.isascii() and s.isdecimal()のように isascii() と組み合わせます - 最後の行の “²” は上付きの「²」です。isdigit() は True を返しますが、int(“²”) は ValueError になりました。数字かどうかの判定には isdigit() ではなく isdecimal() を使いましょう
4300 桁を超える数字の変換は ValueError
import sys
print(sys.get_int_max_str_digits())
n = int("1" * 5000)
4300
Traceback (most recent call last):
……
ValueError: Exceeds the limit (4300 digits) for integer string conversion: value has 5000 digits; use sys.set_int_max_str_digits() to increase the limit
Python 3.11 から(それより前のバージョンにもセキュリティ修正として追加)、10 進数の文字列と int の変換には 4300 桁の上限があります。公式ドキュメントによると、10 進数の変換は桁が増えると時間が急に長くなるため、とても長い数字を送りつけて処理を止める攻撃(サービス妨害)を防ぐための制限です。16 進数・8 進数・2 進数の変換には上限がなく、int(“f” * 5000, 16) はエラーになりませんでした。ふつうの用途で困ることはありませんが、必要なら sys.set_int_max_str_digits() で上限を変えられます。外部から受け取る値に対しては、上限を外さないほうが安全です。
変換で出るエラーのまとめ
| 例外 | 意味 | よくある原因 |
|---|---|---|
| ValueError | 型は合っているが、値の中身が変換できない | int(“3.14”)、int(“1,000”)、int(“”)、int(“g”, 16)、float(“1,5”)、int(float(“nan”)) |
| TypeError | 変換や計算ができない型の組み合わせ | “年齢:” + 20、int(None)、int(255, 16) |
| OverflowError | 数値の範囲を超えた | float(10**400)、int(float(“inf”)) |
エラーが出たら、最後の行の例外の名前と、メッセージの最後に表示される実際の値(’3.14′ や ‘NoneType’ など)を見ると、何を直せばよいかが分かります。
よくある質問
“007” のような先頭の 0 を残したいときは?
int(“007”) は 7 になり、先頭の 0 は消えます。社員番号・郵便番号・電話番号のように「計算しない番号」は、数値にせず文字列のまま持つのが基本です。数値から 0 埋めの文字列に戻したいときは、f"{7:03d}" または str(7).zfill(3) で “007” になります(どちらも実行して確かめました)。
金額の文字列は float と Decimal のどちらに変換すべき?
金額や、桁の多い数は Decimal がおすすめです。Decimal("12345678901234567890.9") を int() にすると 12345678901234567890 と正しく切り捨てられ、float を経由したときのように値が変わりません。Decimal は文字列から作るのが大切なポイントで、詳しくは「PythonのDecimalでお金を正確に計算する方法」で解説しています。
型の間違いを実行前に見つける方法は?
関数に型ヒント(例:def add_one(age: int) -> int:)を書いて mypy でチェックすると、文字列を渡しているところを実行前に見つけられます。やり方は「Pythonの型ヒント入門」で紹介しています。
まとめ
input() やファイルから来た値は文字列なので、計算の前に int() や float() で変換し、文字列とつなぐときは str() か f 文字列を使います。int() は小数の文字列やカンマを受け付けず、float からの変換は 0 の方向へ切り捨てる、16 進数などは int(x, 16) で読み hex()・format() で書く、の 3 点を押さえておけば、型変換のエラーで迷うことはほとんどなくなります。変換できない値が混ざる場面では、ValueError と TypeError だけを受け止める関数を用意しておきましょう。
関連する記事・ツール
- 基数変換ツール【無料・登録不要】2進数・8進数・10進数・16進数を相互変換|2の補数対応
- 2進数・16進数の基本|0xFF・カラーコード・IPアドレスなど仕事で出会う場面を解説
- 浮動小数点数の誤差とは?0.1+0.2が0.3にならない理由と対処法
- PythonのDecimalでお金を正確に計算する方法|quantize・丸め・prec
- Pythonの例外処理入門|try・except・finally・raiseの使い方
- Pythonのf文字列(f-string)の使い方|書式指定・桁区切り・ゼロ埋めを実例で解説