魔法方法之__contains__()

'''
__contains__() 是一个特殊方法，用于定义对象是否包含某个元素的逻辑。它在使用 in 运算符检查成员关系时被调用。

详解：
    1. __contains__(self, item) 方法接受一个参数 item，表示要检查的元素。
    2. 该方法应返回一个布尔值，指示对象是否包含给定的元素。
    3. 当我们使用 in 运算符来检查成员关系时，会调用对象的 __contains__() 方法。

最佳实践：
    1. 在自定义类中实现 __contains__() 方法时，根据具体的业务逻辑判断对象是否包含给定的元素，并返回相应的布尔值。
    2. 如果对象不可变且具有高效的成员测试机制（例如集合或字典），则可以优化 __contains__() 方法的实现。
'''
class MyContainer:
    def __init__(self):
        self.data = [1, 2, 3]

    def __contains__(self, item):
        return item in self.data

my_container = MyContainer()
print(2 in my_container)  # 输出：True
print(4 in my_container)  # 输出：False
'''
可能遇到的坑：
    1. 在自定义类中实现 __contains__() 方法时，要确保返回的布尔值正确反映了对象是否包含给定的元素。否则，会导致不正确的成员测试结果。
    2. 当对象的 __contains__() 方法未被实现时，默认行为是遍历对象来判断给定的元素是否存在。如果对象的元素较多或成员测试需要较长时间，则可能导致性能问题。
'''