Python
PR

Pythonの型変換入門|int・float・strの使い方とValueError・TypeErrorの直し方

Pythonの型変換入門|int・float・strの使い方とValueError・TypeErrorの直し方
hr
記事内に商品プロモーションを含む場合があります

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'>
str(文字列)・int(整数)・float(小数)の 3 つの型の変換を矢印で示した図。int(文字列の 42) で 42、str(42) で文字列の 42、float(文字列の 3.14) で 3.14、str(3.14) で文字列の 3.14、float(3) で 3.0、int(3.99) で 3(0 の方向へ切り捨て)になる。下にはよくあるエラーとして、int(文字列の 3.14) と int(文字列の 1,000) は ValueError、文字列の「年齢:」に 20 を + でつなぐと TypeError になることを示している。
図 1:str・int・float の変換と、よくあるエラー

元の値は変わらず、変換した新しい値が返る点に注意してください。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 だけを受け止める関数を用意しておきましょう。

関連する記事・ツール

ABOUT ME
hr
hr
エンジニアとして働いている hr です。仕事や資格勉強で「こんなツールがあれば」と感じたものを、無料Webツールと解説記事にして発信しています。
記事URLをコピーしました