一、 引言
上节结合案例介绍了重写__repr__方法的关注点,重写__repr__方法的要点是要准确的输出开发人员关注的信息,并便于开发人员使用相关信息。而__str__方法是为最终用户返回类的相关信息,因此需要相关信息容易理解,更需要开发者在自定义类的过程中重写__str__方法。
object类提供的__str__方法,只是简单输出模块名、类名以及对象的ID信息,老猿认为实际上就是在__str__方法直接调用object类的__repr__方法,不过没去研究代码核实。不管怎样,这个信息根本谈不上用户友好度,因此老猿建议对于重要的与客户交互的类重写类的__str__方法。
二、 重写__str__方法
重写__str__方法注意:
- __str__方法是实例方法,因此带一个参数self,也只能带这个参数;
- 输出的信息尽可能容易让客户理解;
- 可以调用父类的__str__方法,也可以不调用,具体需要根据父类输出信息的情况进行评估是否满足客户友好性。不过老猿建议最好调用,如果父类友好性不够建议修改父类的__str__方法。
注意:如果类内未重写__str__方法,但重写了__repr__方法了,则调用__str__方法时Python会直接调用__repr__方法。
三、 例子
- 例子说明
本节继续利用上节的Car类来说明__str__方法重写,在类中重写了__repr__方法和__str__方法,__repr__方法重写是用的上节的内容,__str__方法重写返回的信息包括:
1>证明调用了重写方法的“In str:”提示;
2>使用中文描述的属性名称,以及对应值。
另外在信息查看时,特地调用直接查看对象和打印对象查看输出,看看是否与上节的例子输出不同。 - 案例代码
1> 类定义
class Car():
def __init__(self,brand,type,color,weight,oilcostper100km): #构造方法
self.brand = brand
self.type = type
self.oilcostper100km = oilcostper100km
self.color = color
self.weight = weight
def __repr__(self):
s="In __repr__:\n <{} object at {:#016x}>\n".format(repr(self.__class__),id(self) )#使用类相关的信息输出类名和实例ID
s+=super().__repr__() #直接调用object.__repr__方法输出类信息和实例ID
#通过实例的self.__dict__获取实例的详细属性信息,注意使用了repr函数去获取字典信息字符串
s+='\n'+repr(self.__dict__)
return s
def __str__(self):
return "In __str__:\n 实例属性:{} {},车身颜色{}、车重{}吨、百公里油耗{}升".\
format(self.brand,self.type,self.color,self.weight,self.oilcostper100km)
2>实例定义及查看信息()
car = Car('雪佛兰','科帕奇','白色',1.8,10)
car #查看实例信息,此时会调用__repr__方法
print(car) #查看实例信息,此时会调用__str__方法,但没有重写__str__方法,效果会怎样?
- 案例截图
- 案例总结
通过上述案例说明:
1>重写__str__方法后,使用print(对象)查看对象会触发重写方法的调用,其他触发方式请见《第8.14节 Python类中内置方法的__str__详解》,在此不再展开说明;
2>结合上节的案例一起,这2个案例验证了上节所说明的“自定义类没有重写__str__方法的情况下,Python会直接调用__ repr __方法输出,要输出单独的__str__信息需要重写__str__方法”。
本节结合案例介绍了 __str__方法的重写,可以看到通过重写该方法如果输出数据得当,相关信息有利于最终用户理解。