一文彻底搞懂Python中__str__和__repr__

我们都知道，Python的内置函数 repr()​ 能够把对象用字符串的形式表达出来，方便我们辨认。这就是“字符串表示形式”。repr()​ 就是通过 __repr__​ 这个特殊方法来得到一个对象的字符串表示形式的。

__str__和__repr__有什么异同?

字符串的表示形式

我们都知道，Python的内置函数repr()​能够把对象用字符串的形式表达出来，方便我们辨认。这就是“字符串表示形式”。repr()​就是通过__repr__​这个特殊方法来得到一个对象的字符串表示形式的。如果没有实现__repr__，当我们在控制台里打印一个向量的实例时，得到的字符串可能会是 <Vector object at 0x10a514f98>。

>>> class Example: pass

>>> print(str(Example()))
<__main__.Example object at 0x10a514f98>
>>> print(repr(Example()))
<__main__.Example object at 0x1088eb438>
>>> 
>>> str(Example)
"<class '__main__.Example'>"
>>> repr(Example())
'<__main__.Example object at 0x1088eb438>'

**__str__**​vs.**__repr__**

接下来我们看一看**__str__**和**__repr__**​有哪些异同。根据Python官方文档定义：

• __str__​：通过str(object)以及内置函数format()和print()调用以生成一个对象的“非正式”或格式良好的字符串表示。返回值必须是字符串对象。
• __repr__​：是由repr()内置函数调用，用来输出一个对象的“官方”字符串表示。返回值必须是字符串对象，此方法通常被用于调试。内置类型 object 所定义的默认实现会调用object.__repr__()。

什么正式与非正式格式，你已经搞懵了是吗？没事，我们接着看：

1. 两者都能输出对象

>>> x = 4
>>> repr(x)
'4'
>>> str(x)
'4'
>>> y = 'pythonic'
>>> repr(y)
"'pythonic'"
>>> str(y)
'pythonic'

>>> z = '4'
>>> repr(z)
"'4'"
>>> str(z)  # 注意，此处的输出结果形式跟str(x)一样，但x和z的类型并不一样
'4'
>>> str(x) == str(z)
True
>>> repr(x) == repr(z)
False
>>> str(4) == str("4")
True
>>> repr(4) == repr("4")
False

当 x=4，当 x 为整数类型时，调用str()​和repr()的返回结果是一样，

而当y为字符串类型时，repr(y)​的结果就是“正式”的字符串表示，而str(y)​的结果则是“非正式”的。str()能够让我们最快速了解到对象的内容，可读性较高。

2 .__str__​是可读的，__repr__的目标是明确的

>>> import datetime
>>> d = datetime.datetime.now()
>>> str(d)
'2020-04-04 20:47:46.525245'
>>> repr(d)
'datetime.datetime(2020, 4, 4, 20, 47, 46, 525245)'
>>>

可以看出repr()更能显示出对象的类型、值等信息，对象描述清晰的。

在str()​函数被使用，或是在用print函数打印一个对象的时候才被调用的，并且它返回的字符串对终端用户更友好。

3. 重写__repr__​，那也会使用__str_

class Student():

    def __init__(self, name):
        self.name = name

    def __str__(self):
        return "Name：" + self.name

    def __repr__(self):
        return "姓名：" + self.name


class_one = Student("Alice")
print(class_one)
print(str(class_one))
print(repr(class_one))

输出结果：

Name：Alice
Name：Alice
姓名：Alice

总结

共同点：都是用来输出一个对象

区别：

1. __str__​的目标是可读的，__str__()并不预期返回一个有效的 Python 表达式，但可以使用更方便或更准确的描述信息。
2. __repr__的目标是明确的，所返回的字符串应该准确、无歧义，并且尽可能表达出如何用代码创建出这个被打印的对象。
3. 容器的__str__​方法的使用包含对象的__repr__​