Python魔术方法大全

Python魔术方法大全

在Python中，所有以“__”双下划线包起来的方法，都统称为“Magic Method”（魔术方法）,例如类的初始化方法 init ,Python中所有的魔术方法均在官方文档中有相应描述，这边给大家把所有的魔术方法汇总了一下，希望对大家的学习有所帮助。

1. 基本的魔法方法

名称	说明
new(cls[, …])	new 是在一个对象实例化的时候所调用的第一个方法
init(self[, …])	构造器，当一个实例被创建的时候调用的初始化方法
del(self)	析构器，当一个实例被销毁的时候调用的方法
call(self[, args…])	允许一个类的实例像函数一样被调用：x(a, b) 调用 x.call(a, b)
len(self)	定义当被 len() 调用时的行为
repr(self)	定义当被 repr() 调用时的行为
str(self)	定义当被 str() 调用时的行为
bytes(self)	定义当被 bytes() 调用时的行为
hash(self)	定义当被 hash() 调用时的行为
bool(self)	定义当被 bool() 调用时的行为，应该返回 True 或 False
format(self, format_spec)	定义当被 format() 调用时的行为

2. 有关属性

名称	说明
getattr(self, name)	定义当用户试图获取一个不存在的属性时的行为
getattribute(self, name)	定义当该类的属性被访问时的行为
setattr(self, name, value)	定义当一个属性被设置时的行为
delattr(self, name)	定义当一个属性被删除时的行为
dir(self)	定义当 dir() 被调用时的行为
get(self, instance, owner)	定义当描述符的值被取得时的行为
set(self, instance, value)	定义当描述符的值被改变时的行为
delete(self, instance)	定义当描述符的值被删除时的行为

3. 比较操作符

名称	说明
lt(self, other)	定义小于号的行为：x < y 调用 x.lt(y)
le(self, other)	定义小于等于号的行为：x <= y 调用 x.le(y)
eq(self, other)	定义等于号的行为：x == y 调用 x.eq(y)
ne(self, other)	定义不等号的行为：x != y 调用 x.ne(y)
gt(self, other)	定义大于号的行为：x > y 调用 x.gt(y)
ge(self, other)	定义大于等于号的行为：x >= y 调用 x.ge(y)

4. 算数运算符

名称	说明
add(self, other)	定义加法的行为：+
sub(self, other)	定义减法的行为：-
mul(self, other)	定义乘法的行为：*
truediv(self, other)	定义真除法的行为：/
floordiv(self, other)	定义整数除法的行为：//
mod(self, other)	定义取模算法的行为：%
divmod(self, other)	定义当被 divmod() 调用时的行为
pow(self, other[, modulo])	定义当被 power() 调用或 ** 运算时的行为
lshift(self, other)	定义按位左移位的行为：<<
rshift(self, other)	定义按位右移位的行为：>>
and(self, other)	定义按位与操作的行为：&
xor(self, other)	定义按位异或操作的行为：^
or(self, other)	定义按位或操作的行为：|

5. 反运算

名称	说明
radd(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rsub(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rmul(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rtruediv(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rfloordiv(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rmod(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rdivmod(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rpow(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rlshift(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rrshift(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rand(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
rxor(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）
ror(self, other)	（与上方相同，当左操作数不支持相应的操作时被调用）

6. 增量赋值运算

名称	说明
iadd(self, other)	定义赋值加法的行为：+=
isub(self, other)	定义赋值减法的行为：-=
imul(self, other)	定义赋值乘法的行为：*=
itruediv(self, other)	定义赋值真除法的行为：/=
ifloordiv(self, other)	定义赋值整数除法的行为：//=
imod(self, other)	定义赋值取模算法的行为：%=
ipow(self, other[, modulo])	定义赋值幂运算的行为：**=
ilshift(self, other)	定义赋值按位左移位的行为：<<=
irshift(self, other)	定义赋值按位右移位的行为：>>=
iand(self, other)	定义赋值按位与操作的行为：&=
ixor(self, other)	定义赋值按位异或操作的行为：^=
ior(self, other)	定义赋值按位或操作的行为：|=

7. 一元操作符

名称	说明
pos(self)	定义正号的行为：+x
neg(self)	定义负号的行为：-x
abs(self)	定义当被 abs() 调用时的行为
invert(self)	定义按位求反的行为：~x

8. 类型转换

名称	说明
complex(self)	定义当被 complex() 调用时的行为（需要返回恰当的值）
int(self)	定义当被 int() 调用时的行为（需要返回恰当的值）
float(self)	定义当被 float() 调用时的行为（需要返回恰当的值）
round(self[, n])	定义当被 round() 调用时的行为（需要返回恰当的值）
index(self)	1. 当对象是被应用在切片表达式中时，实现整形强制转换 2. 如果你定义了一个可能在切片时用到的定制的数值型,你应该定义 index 3. 如果 index 被定义，则 int 也需要被定义，且返回相同的值

9. 上下文管理（with 语句）

名称	说明
enter(self)	1. 定义当使用 with 语句时的初始化行为 2. enter 的返回值被 with 语句的目标或者 as 后的名字绑定
exit(self, exc_type, exc_value, traceback)	1. 定义当一个代码块被执行或者终止后上下文管理器应该做什么 2. 一般被用来处理异常，清除工作或者做一些代码块执行完毕之后的日常工作

10. 容器类型

名称	说明
len(self)	定义当被 len() 调用时的行为（返回容器中元素的个数）
getitem(self, key)	定义获取容器中指定元素的行为，相当于 self[key]
setitem(self, key, value)	定义设置容器中指定元素的行为，相当于 self[key] = value
delitem(self, key)	定义删除容器中指定元素的行为，相当于 del self[key]
iter(self)	定义当迭代容器中的元素的行为
reversed(self)	定义当被 reversed() 调用时的行为
contains(self, item)	定义当使用成员测试运算符（in 或 not in）时的行为

在Python中，所有以__双下划线包起来的方法，都统称为"魔术方法"。比如我们接触最多的__init__。 有些魔术方法,我们可能以后一辈子都不会再遇到了,这里也就只是简单介绍下; 而有些魔术方法,巧妙使用它可以构造出非常优美的代码,比如将复杂的逻辑封装成简单的API。

11. 构造和初始化

__init__我们很熟悉了,它在对象初始化的时候调用,我们一般将它理解为"构造函数".

实际上, 当我们调用x = SomeClass()的时候调用,__init__并不是第一个执行的, __new__才是。所以准确来说,是__new__和__init__共同构成了"构造函数".

__new__是用来创建类并返回这个类的实例, 而__init__只是将传入的参数来初始化该实例.

new__在创建一个实例的过程中必定会被调用,但__init__就不一定，比如通过pickle.load的方式反序列化一个实例时就不会调用__init。

__new__方法总是需要返回该类的一个实例，而__init__不能返回除了None的任何值。比如下面例子:

class Foo(object):

    def __init__(self):
        print 'foo __init__'
        return None  # 必须返回None,否则抛TypeError

    def __del__(self):
        print 'foo __del__'

实际中,你很少会用到__new__，除非你希望能够控制类的创建。 如果要讲解__new__，往往需要牵扯到metaclass(元类)的介绍。

对于__new__的重载，Python文档中也有了详细的介绍。 在对象的生命周期结束时, __del__会被调用,可以将__del__理解为"析构函数".

__del__定义的是当一个对象进行垃圾回收时候的行为。 有一点容易被人误解, 实际上，x.del() 并不是对于del x的实现,但是往往执行del x时会调用x.del().

怎么来理解这句话呢? 继续用上面的Foo类的代码为例:

class Foo(object):

    def __init__(self):
        print 'foo __init__'
        return None  # 必须返回None,否则抛TypeError

    def __del__(self):
        print 'foo __del__'
        
foo = Foo()
foo.__del__()
print foo
del foo
print foo  # NameError, foo is not defined

如果调用了foo.del()，对象本身仍然存在. 但是调用了del foo, 就再也没有foo这个对象了.

请注意，如果解释器退出的时候对象还存在，就不能保证 del 被确切的执行了。所以__del__并不能替代良好的编程习惯。

比如，在处理socket时，及时关闭结束的连接。

12. 属性访问控制

总有人要吐槽Python缺少对于类的封装,比如希望Python能够定义私有属性，然后提供公共可访问的getter和 setter。Python其实可以通过魔术方法来实现封装。

12.1 getattr(self, name)

该方法定义了你试图访问一个不存在的属性时的行为。因此，重载该方法可以实现捕获错误拼写然后进行重定向, 或者对一些废弃的属性进行警告。

12.2 setattr(self, name, value)

setattr 是实现封装的解决方案，它定义了你对属性进行赋值和修改操作时的行为。

不管对象的某个属性是否存在,它都允许你为该属性进行赋值,因此你可以为属性的值进行自定义操作。有一点需要注意，实现__setattr__时要避免"无限递归"的错误，下面的代码示例中会提到。

12.3 delattr(self, name)

__delattr__与__setattr__很像，只是它定义的是你删除属性时的行为。实现__delattr__是同时要避免"无限递归"的错误。

12.4 getattribute(self, name)

__getattribute__定义了你的属性被访问时的行为，相比较，__getattr__只有该属性不存在时才会起作用。

因此，在支持__getattribute__的Python版本,调用__getattr__前必定会调用 getattribute。__getattribute__同样要避免"无限递归"的错误。

需要提醒的是，最好不要尝试去实现__getattribute__,因为很少见到这种做法，而且很容易出bug。

例子说明__setattr__的无限递归错误:

def __setattr__(self, name, value):
    self.name = value
    # 每一次属性赋值时, __setattr__都会被调用，因此不断调用自身导致无限递归了。

因此正确的写法应该是:

def __setattr__(self, name, value):
    self.__dict__[name] = value

__delattr__如果在其实现中出现del self.name 这样的代码也会出现"无限递归"错误，这是一样的原因。

下面的例子很好的说明了上面介绍的4个魔术方法的调用情况:

class Access(object):

    def __getattr__(self, name):
        print '__getattr__'
        return super(Access, self).__getattr__(name)

    def __setattr__(self, name, value):
        print '__setattr__'
        return super(Access, self).__setattr__(name, value)

    def __delattr__(self, name):
        print( '__delattr__')
        return super(Access, self).__delattr__(name)

    def __getattribute__(self, name):
        print( '__getattribute__')
        return super(Access, self).__getattribute__(name)

access = Access()
access.attr1 = True  # __setattr__调用
access.attr1  # 属性存在,只有__getattribute__调用
try:
    access.attr2  # 属性不存在, 先调用__getattribute__, 后调用__getattr__
except AttributeError:
    pass
del access.attr1  # __delattr__调用

13. 描述器对象

我们从一个例子来入手,介绍什么是描述符,并介绍__get__, set, delete 的使用。(放在这里介绍是为了跟上一小节介绍的魔术方法作对比)。

我们知道，距离既可以用单位"米"表示,也可以用单位"英尺"表示。 现在我们定义一个类来表示距离,它有两个属性: 米和英尺。

class Meter(object):
    '''Descriptor for a meter.'''
    def __init__(self, value=0.0):
        self.value = float(value)
    def __get__(self, instance, owner):
        return self.value
    def __set__(self, instance, value):
        self.value = float(value)

class Foot(object):
    '''Descriptor for a foot.'''
    def __get__(self, instance, owner):
        return instance.meter * 3.2808
    def __set__(self, instance, value):
        instance.meter = float(value) / 3.2808

class Distance(object):
    meter = Meter()
    foot = Foot()

d = Distance()
print( d.meter, d.foot) # 0.0, 0.0
d.meter = 1
print( d.meter, d.foot ) # 1.0 3.2808
d.meter = 2
print( d.meter, d.foot ) # 2.0 6.5616

在上面例子中,在还没有对Distance的实例赋值前, 我们认为meter和foot应该是各自类的实例对象, 但是输出却是数值。这是因为__get__发挥了作用. 我们只是修改了meter,并且将其赋值成为int，但foot也修改了。这是__set__发挥了作用。

描述器对象(Meter、Foot)不能独立存在, 它需要被另一个所有者类(Distance)所持有。 描述器对象可以访问到其拥有者实例的属性，比如例子中Foot的instance.meter。

在面向对象编程时，如果一个类的属性有相互依赖的关系时，使用描述器来编写代码可以很巧妙的组织逻辑。 在Django的ORM中, models.Model中的IntegerField等, 就是通过描述器来实现功能的。

一个类要成为描述器，必须实现__get__, set, delete 中的至少一个方法。下面简单介绍下:

13.1 get(self, instance, owner)

参数instance是拥有者类的实例。参数owner是拥有者类本身。__get__在其拥有者对其读值的时候调用。

13.2 set(self, instance, value)

__set__在其拥有者对其进行修改值的时候调用。

13.3 delete(self, instance)

__delete__在其拥有者对其进行删除的时候调用。

14. 构造自定义容器(Container)

在Python中，常见的容器类型有: dict, tuple, list, string。 其中tuple, string是不可变容器，dict, list是可变容器。

可变容器和不可变容器的区别在于，不可变容器一旦赋值后，不可对其中的某个元素进行修改。 比如定义了l = [1, 2, 3]和t = (1, 2, 3)后, 执行l[0] = 0是可以的，但执行t[0] = 0则会报错。

• 如果我们要自定义一些数据结构，使之能够跟以上的容器类型表现一样，那就需要去实现某些协议。 这里的协议跟其他语言中所谓的"接口"概念很像，一样的需要你去实现才行，只不过没那么正式而已。
• 如果要自定义不可变容器类型，只需要定义__len__ 和 __getitem__方法;
• 如果要自定义可变容器类型，还需要在不可变容器类型的基础上增加定义__setitem__ 和 delitem。
• 如果你希望你的自定义数据结构还支持"可迭代", 那就还需要定义__iter__。

14.1 len(self)

需要返回数值类型，以表示容器的长度。该方法在可变容器和不可变容器中必须实现。/p>

14.2 getitem(self, key)

当你执行self[key]的时候，调用的就是该方法。该方法在可变容器和不可变容器中也都必须实现。 调用的时候,如果key的类型错误，该方法应该抛出TypeError； 如果没法返回key对应的数值时,该方法应该抛出ValueError。/p>

14.3 setitem(self, key, value)

当你执行self[key] = value时，调用的是该方法。/p>

14.4 delitem(self, key)

当你执行del self[key]的时候，调用的是该方法。/p>

14.5 iter(self)

该方法需要返回一个迭代器(iterator)。当你执行for x in container: 或者使用iter(container)时，该方法被调用。/p>

14.6 reversed(self)

如果想要该数据结构被內建函数reversed()支持,就还需要实现该方法。/p>

14.7 contains(self, item)

如果定义了该方法，那么在执行item in container 或者 item not in container时该方法就会被调用。 如果没有定义，那么Python会迭代容器中的元素来一个一个比较，从而决定返回True或者False。/p>

14.8 missing(self, key)

dict字典类型会有该方法，它定义了key如果在容器中找不到时触发的行为。 比如d = {‘a’: 1}, 当你执行d[notexist]时，d.missing(‘notexist’)就会被调用。/p>

下面举例，使用上面讲的魔术方法来实现Haskell语言中的一个数据结构。

# -*- coding: utf-8 -*-
class FunctionalList:
    ''' 实现了内置类型list的功能,并丰富了一些其他方法: head, tail, init, last, drop, take'''

    def __init__(self, values=None):
        if values is None:
            self.values = []
        else:
            self.values = values

    def __len__(self):
        return len(self.values)

    def __getitem__(self, key):
        return self.values[key]

    def __setitem__(self, key, value):
        self.values[key] = value

    def __delitem__(self, key):
        del self.values[key]

    def __iter__(self):
        return iter(self.values)

    def __reversed__(self):
        return FunctionalList(reversed(self.values))

    def append(self, value):
        self.values.append(value)
    def head(self):
        # 获取第一个元素
        return self.values[0]
    def tail(self):
        # 获取第一个元素之后的所有元素
        return self.values[1:]
    def init(self):
        # 获取最后一个元素之前的所有元素
        return self.values[:-1]
    def last(self):
        # 获取最后一个元素
        return self.values[-1]
    def drop(self, n):
        # 获取所有元素，除了前N个
        return self.values[n:]
    def take(self, n):
        # 获取前N个元素
        return self.values[:n]

我们再举个例子，实现Perl语言的AutoVivification,它会在你每次引用一个值未定义的属性时为你自动创建数组或者字典。

class AutoVivification(dict):
    """Implementation of perl's autovivification feature."""
    def __missing__(self, key):
        value = self[key] = type(self)()
        return value

weather = AutoVivification()
weather['china']['guangdong']['shenzhen'] = 'sunny'
weather['china']['hubei']['wuhan'] = 'windy'
weather['USA']['California']['Los Angeles'] = 'sunny'
print weather

# 结果输出:{'china': {'hubei': {'wuhan': 'windy'}, 'guangdong': {'shenzhen': 'sunny'}}, 'USA':    {'California': {'Los Angeles': 'sunny'}}}

在Python中，关于自定义容器的实现还有更多实用的例子，但只有很少一部分能够集成在Python标准库中，比如Counter, OrderedDict等。

15. 上下文管理

with声明是从Python2.5开始引进的关键词。你应该遇过这样子的代码:

with open('foo.txt') as bar:
    # do something with bar

在with声明的代码段中，我们可以做一些对象的开始操作和清除操作,还能对异常进行处理。 这需要实现两个魔术方法: enter 和 exit。

__enter__(self)

__enter__会返回一个值，并赋值给as关键词之后的变量。在这里，你可以定义代码段开始的一些操作。

__exit__(self, exception_type, exception_value, traceback)

__exit__定义了代码段结束后的一些操作，可以这里执行一些清除操作，或者做一些代码段结束后需要立即执行的命令，比如文件的关闭，socket断开等。如果代码段成功结束，那么exception_type, exception_value, traceback 三个参数传进来时都将为None。如果代码段抛出异常，那么传进来的三个参数将分别为: 异常的类型，异常的值，异常的追踪栈。

如果__exit__返回True, 那么with声明下的代码段的一切异常将会被屏蔽。

如果__exit__返回None, 那么如果有异常，异常将正常抛出，这时候with的作用将不会显现出来。

例如，这该示例中，IndexError始终会被隐藏，而TypeError始终会抛出。

class DemoManager(object):

    def __enter__(self):
        pass

    def __exit__(self, ex_type, ex_value, ex_tb):
        if ex_type is IndexError:
            print( ex_value.__class__)
            return True
        if ex_type is TypeError:
            print( ex_value.__class__)
            return  # return None

with DemoManager() as nothing:
    data = [1, 2, 3]
    data[4]  # raise IndexError, 该异常被__exit__处理了

with DemoManager() as nothing:
    data = [1, 2, 3]
    data['a']  # raise TypeError, 该异常没有被__exit__处理

'''

输出:

<type 'exceptions.IndexError'>
<type 'exceptions.TypeError'>
Traceback (most recent call last):
  ...
'''

16. 对象的序列化

Python对象的序列化操作是pickling进行的。pickling非常的重要，以至于Python对此有单独的模块pickle，还有一些相关的魔术方法。使用pickling, 你可以将数据存储在文件中，之后又从文件中进行恢复。

下面举例来描述pickle的操作。从该例子中也可以看出,如果通过pickle.load 初始化一个对象, 并不会调用__init__方法。

# -*- coding: utf-8 -*-
from datetime import datetime
import pickle

class Distance(object):

    def __init__(self, meter):
        print( 'distance __init__')
        self.meter = meter

data = {
    
    
    'foo': [1, 2, 3],
    'bar': ('Hello', 'world!'),
    'baz': True,
    'dt': datetime(2016, 10, 01),
    'distance': Distance(1.78),
}
print( 'before dump:', data)
with open('data.pkl', 'wb') as jar:
    pickle.dump(data, jar)  # 将数据存储在文件中

del data
print( 'data is deleted!')

with open('data.pkl', 'rb') as jar:
    data = pickle.load(jar)  # 从文件中恢复数据
print( 'after load:', data)

值得一提，从其他文件进行pickle.load操作时，需要注意有恶意代码的可能性。另外，Python的各个版本之间,pickle文件可能是互不兼容的。 pickling并不是Python的內建类型，它支持所有实现pickle协议(可理解为接口)的类。pickle协议有以下几个可选方法来自定义Python对象的行为。

16.1 getinitargs(self)

如果你希望unpickle时，init__方法能够调用，那么就需要定义__getinitargs, 该方法需要返回一系列参数的元组，这些参数就是传给__init__的参数。 该方法只对old-style class有效。所谓old-style class,指的是不继承自任何对象的类，往往定义时这样表示: class A:, 而非class A(object):

16.2 getnewargs(self)

跟__getinitargs__很类似，只不过返回的参数元组将传值给__new__

16.3 getstate(self)

在调用pickle.dump时，默认是对象的__dict__属性被存储，如果你要修改这种行为，可以在__getstate__方法中返回一个state。state将在调用pickle.load时传值给__setstate__

16.4 setstate(self, state)

一般来说,定义了__getstate__,就需要相应地定义__setstate__来对__getstate__返回的state进行处理。

16.5 reduce(self)

如果pickle的数据包含了自定义的扩展类（比如使用C语言实现的Python扩展类）时，就需要通过实现__reduce__方法来控制行为了。由于使用过于生僻，这里就不展开继续讲解了。 令人容易混淆的是，我们知道, reduce()是Python的一个內建函数, 需要指出__reduce__并非定义了reduce()的行为，二者没有关系。

16.6 reduce_ex(self)

reduce_ex 是为了兼容性而存在的, 如果定义了__reduce_ex__, 它将代替__reduce__ 执行。

下面的代码示例很有意思，我们定义了一个类Slate(中文是板岩的意思)。这个类能够记录历史上每次写入给它的值,但每次pickle.dump时当前值就会被清空，仅保留了历史。

# -*- coding: utf-8 -*-
import pickle
import time

class Slate:
    '''Class to store a string and a changelog, and forget its value when pickled.'''
    def __init__(self, value):
        self.value = value
        self.last_change = time.time()
        self.history = []

    def change(self, new_value):
        # 修改value, 将上次的valeu记录在history
        self.history.append((self.last_change, self.value))
        self.value = new_value
        self.last_change = time.time()

    def print(_changes(self):)
        print( 'Changelog for Slate object:')
        for k, v in self.history:
            print( '%s    %s' % (k, v))

    def __getstate__(self):
        # 故意不返回self.value和self.last_change,
        # 以便每次unpickle时清空当前的状态，仅仅保留history
        return self.history

    def __setstate__(self, state):
        self.history = state
        self.value, self.last_change = None, None

slate = Slate(0)
time.sleep(0.5)
slate.change(100)
time.sleep(0.5)
slate.change(200)
slate.change(300)
slate.print(_changes()  # 与下面的输出历史对比)
with open('slate.pkl', 'wb') as jar:
    pickle.dump(slate, jar)
del slate  # delete it
with open('slate.pkl', 'rb') as jar:
    slate = pickle.load(jar)
print( 'current value:', slate.value ) # None
print( slate.print_changes())  # 输出历史记录与上面一致

17. 运算符相关的魔术方法

运算符相关的魔术方法实在太多了，也很好理解。在其他语言里，也有重载运算符的操作。

• 比较运算符

17.1 cmp(self, other)

如果该方法返回负数，说明self < other; 返回正数，说明self > other; 返回0说明self == other。 强烈不推荐来定义__cmp__, 取而代之, 最好分别定义__lt__等方法从而实现比较功能。__cmp__在Python3中被废弃了。

17.2 eq(self, other)

定义了比较操作符==的行为.

17.3 ne(self, other)

定义了比较操作符!=的行为.

17.4 lt(self, other)

定义了比较操作符<的行为.

17.5 gt(self, other)

定义了比较操作符>的行为.

17.6 le(self, other)

定义了比较操作符<<=的行为.

17.7 ge(self, other)

定义了比较操作符>=的行为.

下面我们定义一种类型Word, 它会使用单词的长度来进行大小的比较, 而不是采用str的比较方式。

但是为了避免 Word(‘bar’) == Word(‘foo’) 这种违背直觉的情况出现,并没有定义__eq__, 因此Word会使用它的父类(str)中的__eq__来进行比较。

下面的例子中也可以看出: 在编程语言中, 如果a >=b and a <= b, 并不能推导出a == b这样的结论。

# -*- coding: utf-8 -*-
class Word(str):
    '''存储单词的类，定义比较单词的几种方法'''
    def __new__(cls, word):
        # 注意我们必须要用到__new__方法，因为str是不可变类型
        # 所以我们必须在创建的时候将它初始化
        if ' ' in word:
            print( "Value contains spaces. Truncating to first space.")
            word = word[:word.index(' ')]  # 单词是第一个空格之前的所有字符
        return str.__new__(cls, word)

    def __gt__(self, other):
        return len(self) > len(other)
    def __lt__(self, other):
        return len(self) < len(other)
    def __ge__(self, other):
        return len(self) >= len(other)
    def __le__(self, other):
        return len(self) <= len(other)

print( 'foo < fool:', Word('foo') < Word('fool'))  # True
print( 'foolish > fool:', Word('foolish') > Word('fool') ) # True
print( 'bar >= foo:', Word('bar') >= Word('foo') ) # True
print( 'bar <= foo:', Word('bar') <= Word('foo'))  # True
print( 'bar == foo:', Word('bar') == Word('foo')))  # False, 用了str内置的比较方法来进行比较
print( 'bar != foo:', Word('bar') != Word('foo') ) # True

• 一元运算符和函数

17.8 pos(self)

实现了’+'号一元运算符(比如+some_object)

17.9 neg(self)

实现了’-'号一元运算符(比如-some_object)

17.10 invert(self)

实现了_{号(波浪号)一元运算符(比如}some_object)

17.11 abs(self)

实现了abs()內建函数.

17.12 round(self, n)

实现了round()内建函数. 参数n表示四舍五进的精度.

17.13 floor(self)

实现了math.floor(), 向下取整.

17.14 ceil(self)

实现了math.ceil(), 向上取整.

17.15 trunc(self)

实现了math.trunc(), 向0取整.

• 算术运算符

17.16 add(self, other)

实现了加号运算.

17.17 sub(self, other)

实现了减号运算.

17.18 mul(self, other)

实现了乘法运算.

17.19 floordiv(self, other)

实现了//运算符.

17.20 div(self, other)

实现了/运算符. 该方法在Python3中废弃. 原因是Python3中，division默认就是true division.

17.21 truediv(self, other)

实现了true division. 只有你声明了from future import division该方法才会生效.

17.22 mod(self, other)

实现了%运算符, 取余运算.

17.23 divmod(self, other)

实现了divmod()內建函数.

17.24 pow(self, other)

实现了**操作. N次方操作.

17.25 lshift(self, other)

实现了位操作<<.

17.26 rshift(self, other)

实现了位操作>>.

17.27 and(self, other)

实现了位操作&.

17.28 or(self, other)

实现了位操作|

17.29 xor(self, other)

实现了位操作^

• 反算术运算符

这里只需要解释一下概念即可。假设针对some_object这个对象:

17.30 some_object + other

上面的代码非常正常地实现了some_object的__add__方法。那么如果遇到相反的情况呢?

17.31 other + some_object

这时候，如果other没有定义__add__方法，但是some_object定义了__radd__, 那么上面的代码照样可以运行。这里的__radd__(self, other)就是__add__(self, other)的反算术运算符。所以，类比的，我们就知道了更多的反算术运算符, 就不一一展开了:

17.32 rsub(self, other)

17.33 rmul(self, other

17.34 rmul(self, other)

17.35 rfloordiv(self, other)

17.36 rdiv(self, other)

17.37 rtruediv(self, other)

17.38 rmod(self, other)

17.39 rdivmod(self, other)

17.40 rpow(self, other)

17.41 rlshift(self, other)

17.42 rrshift(self, other)

17.43 rand(self, other)

17.44 ror(self, other)

17.45 rxor(self, other)

• 增量赋值

这也是只要理解了概念就容易掌握的运算。举个例子:

x = 5
x += 1  # 这里的+=就是增量赋值，将x+1赋值给了x

因此对于a += b, iadd 将返回a + b, 并赋值给a。所以很容易理解下面的魔术方法了:

17.46 iadd(self, other)

17.47 isub(self, other)

17.48 imul(self, other)

17.49 ifloordiv(self, other)

17.50 idiv(self, other)

17.51 itruediv(self, other)

17.52 imod(self, other)

17.53 ipow(self, other)

17.54 ilshift(self, other)

17.55 irshift(self, other)

17.56 iand(self, other)

17.57 ior(self, other)

17.58 ixor(self, other)

• 类型转化

17.59 int(self)

实现了类型转化为int的行为.

17.60 long(self)

实现了类型转化为long的行为.

17.61 float(self)

实现了类型转化为float的行为.

17.62 complex(self)

实现了类型转化为complex(复数, 也即1+2j这样的虚数)的行为.

17.63 oct(self)

实现了类型转化为八进制数的行为.

17.64 hex(self)

实现了类型转化为十六进制数的行为.

17.65 index(self)

在切片运算中将对象转化为int, 因此该方法的返回值必须是int。用一个例子来解释这个用法。

class Thing(object):
    def __index__(self):
        return 1

thing = Thing()
list_ = ['a', 'b', 'c']
print( list_[thing])  # 'b'

print( list_[thing:thing])  # []

上面例子中, list_[thing]的表现跟list_[1]一致，正是因为Thing实现了__index__方法。

可能有的人会想，list_[thing]为什么不是相当于list_[int(thing)]呢? 通过实现Thing的__int__方法能否达到这个目的呢? 显然不能。如果真的是这样的话，那么list_[1.1:2.2]这样的写法也应该是通过的。

而实际上，该写法会抛出TypeError: slice indices must be integers or None or have an index method

下面我们再做个例子,如果对一个dict对象执行dict_[thing]会怎么样呢?

dict_ = {
    
    1: 'apple', 2: 'banana', 3: 'cat'}
print( dict_[thing])  # raise KeyError

这个时候就不是调用__index__了。虽然list和dict都实现了__getitem__方法, 但是它们的实现方式是不一样的。 如果希望上面例子能够正常执行, 需要实现Thing的__hash__ 和 __eq__方法.

class Thing(object):
    def __hash__(self):
        return 1
    def __eq__(self, other):
        return hash(self) == hash(other)

dict_ = {
    
    1: 'apple', 2: 'banana', 3: 'cat'}
print( dict_[thing])  # apple
__coerce__(self, other)

• 实现了混合模式运算。

要了解这个方法,需要先了解coerce()内建函数: 官方文档上的解释是, coerce(x, y)返回一组数字类型的参数, 它们被转化为同一种类型，以便它们可以使用相同的算术运算符进行操作。如果过程中转化失败，抛出TypeError。

比如对于coerce(10, 10.1), 因为10和10.1在进行算术运算时，会先将10转为10.0再来运算。因此coerce(10, 10.1)返回值是(10.0, 10.1). __coerce__在Python3中废弃了。

• 其他魔术方法

还没讲到的魔术方法还有很多，但有些我觉得很简单，或者很少见，就不再累赘展开说明了。

17.66 str(self)

对实例使用str()时调用。

17.67 repr(self)

对实例使用repr()时调用。str()和repr()都是返回一个代表该实例的字符串， 主要区别在于: str()的返回值要方便人来看,而repr()的返回值要方便计算机看。

17.68 unicode(self)

对实例使用unicode()时调用。unicode()与str()的区别在于: 前者返回值是unicode, 后者返回值是str。unicode和str都是basestring的子类。

当你对一个类只定义了__str__但没定义__unicode__时,__unicode__会根据__str__的返回值自动实现,即return unicode(self.str()); 但返回来则不成立。

class StrDemo2:
    def __str__(self):
        return 'StrDemo2'

class StrDemo3:
    def __unicode__(self):
        return u'StrDemo3'

demo2 = StrDemo2()
print str(demo2)  # StrDemo2
print unicode(demo2)  # StrDemo2

demo3 = StrDemo3()
print( str(demo3))  # <__main__.StrDemo3 instance>
print( unicode(demo3)) # StrDemo3
#__format__(self, formatstr)
#"Hello, {0:abc}".format(a)等价于format(a, "abc"), 等价于a.__format__("abc")。

这在需要格式化展示对象的时候非常有用，比如格式化时间对象。

17.69 hash(self)

对实例使用hash()时调用, 返回值是数值类型。

17.70 nonzero(self)

对实例使用bool()时调用, 返回True或者False。 你可能会问, 为什么不是命名为__bool__? 我也不知道。 我只知道该方法在Python3中改名为__bool__了。

17.71 dir(self)

对实例使用dir()时调用。通常实现该方法是没必要的。

17.72 sizeof(self)

对实例使用sys.getsizeof()时调用。返回对象的大小，单位是bytes。

17.73 instancecheck(self, instance)

对实例调用isinstance(instance, class)时调用。 返回值是布尔值。它会判断instance是否是该类的实例。

17.74 subclasscheck(self, subclass)

对实例使用issubclass(subclass, class)时调用。返回值是布尔值。它会判断subclass否是该类的子类。

17.75 copy(self)

对实例使用copy.copy()时调用。返回"浅复制"的对象。

17.76 deepcopy(self, memodict={})

对实例使用copy.deepcopy()时调用。返回"深复制"的对象。

17.77 call(self, [args…])

该方法允许类的实例跟函数一样表现:

class XClass:
    def __call__(self, a, b):
        return a + b

def add(a, b):
    return a + b

x = XClass()
print('x(1, 2)', x(1, 2)) 
print( 'callable(x)', callable(x))   # True
print('add(1, 2)', add(1, 2)) 
print( 'callable(add)', callable(add))   # True

18. Python3中的差异

• Python3中，str与unicode的区别被废除了,因而__unicode__没有了，取而代之地出现了__bytes__.
• Python3中，division默认就是true division, 因而__div__废弃.
• __coerce__因存在冗余而废弃.
• __cmp__因存在冗余而废弃.
• nonzero__改名为__bool.