Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】Add::__str__()メソッドの使い方

__str__メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__str__メソッドは、Addクラスのインスタンスの人間が読みやすい文字列表現を取得するために実行されるメソッドです。Pythonの組み込み機能の一つであり、オブジェクトを視覚的に理解しやすい形に変換する役割を担っています。

このメソッドが呼び出される主な状況は、print()関数を使ってAddクラスのオブジェクトを出力する際や、str()関数を用いてオブジェクトを明示的に文字列型に変換する際などです。例えば、Addクラスのオブジェクトが内部で複数のデータを持っている場合でも、__str__メソッドを適切に実装することで、そのオブジェクトがどのような状態にあるのかを簡潔な文字列で表現することができます。

__str__メソッドは、必ず文字列型の値を返す必要があります。この戻り値の文字列は、そのオブジェクトの目的や内容をユーザーや開発者にとって理解しやすいように記述されているべきです。デバッグ時の情報表示、ログファイルへの出力、ユーザーインターフェースでのオブジェクト情報の表示など、様々な場面で活用されます。

また、__repr__という類似のメソッドも存在しますが、__str__が主にエンドユーザー向けの分かりやすい表現を提供するのに対し、__repr__はオブジェクトを再構築できるような開発者向けの厳密な表現を返すことが一般的です。独自のクラスを設計する際には、__str__メソッドを実装することで、そのクラスのオブジェクトをより直感的に扱えるようになり、開発効率の向上にも繋がります。

構文(syntax)

1class MyClass:
2    def __str__(self) -> str:
3        # このメソッドはオブジェクトの文字列表現を返す必要があります。
4        # 例: return f"MyClass object with some_attribute={self.some_attribute}"
5        return "String representation of MyClass object"

引数(parameters)

self

  • self: str: オブジェクト自身の文字列表現

戻り値(return)

str

このメソッドは、オブジェクトの文字列表現を返します。これにより、print()関数などでオブジェクトの内容を人間が読める形式で表示できます。

関連コンテンツ

関連プログラミング言語