魔法方法之__contains__()

 1 '''
 2 __contains__() 是一个特殊方法，用于定义对象是否包含某个元素的逻辑。它在使用 in 运算符检查成员关系时被调用。
 3 
 4 详解：
 5     1. __contains__(self, item) 方法接受一个参数 item，表示要检查的元素。
 6     2. 该方法应返回一个布尔值，指示对象是否包含给定的元素。
 7     3. 当我们使用 in 运算符来检查成员关系时，会调用对象的 __contains__() 方法。
 8 
 9 最佳实践：
10     1. 在自定义类中实现 __contains__() 方法时，根据具体的业务逻辑判断对象是否包含给定的元素，并返回相应的布尔值。
11     2. 如果对象不可变且具有高效的成员测试机制（例如集合或字典），则可以优化 __contains__() 方法的实现。
12 '''
13 class MyContainer:
14     def __init__(self):
15         self.data = [1, 2, 3]
16 
17     def __contains__(self, item):
18         return item in self.data
19 
20 my_container = MyContainer()
21 print(2 in my_container)  # 输出：True
22 print(4 in my_container)  # 输出：False
23 '''
24 可能遇到的坑：
25     1. 在自定义类中实现 __contains__() 方法时，要确保返回的布尔值正确反映了对象是否包含给定的元素。否则，会导致不正确的成员测试结果。
26     2. 当对象的 __contains__() 方法未被实现时，默认行为是遍历对象来判断给定的元素是否存在。如果对象的元素较多或成员测试需要较长时间，则可能导致性能问题。
27 '''