Pythonでデータ型を文字列に変換する方法｜str()関数と__str__()メソッドの使い方

Pythonでは、str()関数を使うことで、あらゆる組み込みデータ型（int、float、complex、list、tuple、dictなど）を簡単に文字列表現へ変換できます。また、ユーザー定義クラスの場合は__str__()メソッドを定義しておくことで、オブジェクトをわかりやすい文字列として出力できるようになります。

組み込みデータ型を文字列に変換する

str()関数の引数に数値やリストなどのオブジェクトを渡すと、その文字列表現が文字列（str型）として返されます。

>>> str(10)
'10'
>>> str(11.11)
'11.11'
>>> str(3+4j)
'(3+4j)'
>>> str([1,2,3])
'[1, 2, 3]'
>>> str((1,2,3))
'(1, 2, 3)'
>>> str({1:11, 2:22, 3:33})
'{1: 11, 2: 22, 3: 33}'

このように、整数・浮動小数点数・複素数・リスト・タプル・辞書など、すべての組み込み型はstr()関数ひとつで文字列化できます。数値を文字列と連結したい場合などにもよく使われる基本的なテクニックです。

ユーザー定義クラスを文字列に変換する

自作したクラスのオブジェクトを文字列に変換したい場合は、クラス内に__str__()メソッドを定義する必要があります。このメソッドは、str()関数やprint()関数が呼び出されたときに自動的に実行され、その戻り値がオブジェクトの文字列表現として使用されます。

>>> class rectangle:
def __init__(self):
self.l=10
self.b=10
def __str__(self):
return 'length={} breadth={}'.format(self.l, self.b)

>>> r1=rectangle()
>>> str(r1)
'length=10 breadth=10'

なお、__str__()メソッドを定義していない場合、str()を実行すると「<__main__.rectangle object at 0x...>」のようにオブジェクトのアドレス情報が表示されるだけです。デバッグやログ出力の可読性を高めるためにも、ユーザー定義クラスには__str__()を定義しておくことをおすすめします。

まとめ

• 組み込みデータ型はstr()関数ですべて文字列に変換できる
• ユーザー定義クラスは__str__()メソッドを定義することで、独自の文字列表現を返せる