collections.abc ---容器的抽象基类¶
3.3 新版功能: 以前，这个模块是 collections 模块。
本模块提供 abstract base classes 它可以用来测试一个类是否提供了一个特定的接口；例如，它是可hash的还是映射的。
集合抽象基类¶
Collections模块提供以下功能 ABCs ：
ABC |
继承自 |
抽象方法 |
混合法 |
|---|---|---|---|
|
|||
|
|||
|
|||
|
|
||
|
|||
|
|
||
|
|||
|
|||
|
|||
|
|
||
|
继承 |
||
|
继承 |
||
|
|
||
|
继承 |
||
|
|
||
|
继承 |
||
|
|||
|
|||
|
|||
|
|||
|
|||
|
|
||
|
|||
|
|
||
|
|
- class collections.abc.Container¶
ABC课程提供
__contains__()方法。
- class collections.abc.Hashable¶
ABC课程提供
__hash__()方法。
- class collections.abc.Sized¶
ABC课程提供
__len__()方法。
- class collections.abc.Callable¶
ABC课程提供
__call__()方法。
- class collections.abc.Iterable¶
ABC课程提供
__iter__()方法。检查
isinstance(obj, Iterable)检测注册为Iterable或者有一个__iter__()方法，但它不检测使用__getitem__()方法。确定对象是否为 iterable 是调用来的iter(obj).
- class collections.abc.Collection¶
大小不可更改容器类的ABC。
3.6 新版功能.
- class collections.abc.Iterator¶
ABC课程提供
__iter__()和__next__()方法。另见定义 iterator .
- class collections.abc.Reversible¶
ABC为也提供
__reversed__()方法。3.6 新版功能.
- class collections.abc.Generator¶
ABC用于实现中定义的协议的生成器类 PEP 342 它用
send()，throw()和close()方法。另见定义 generator .3.5 新版功能.
- class collections.abc.Sequence¶
- class collections.abc.MutableSequence¶
- class collections.abc.ByteString¶
只读和可变的ABC sequences .
实现说明：一些混合方法，例如
__iter__()，__reversed__()和index()，重复调用基础__getitem__()方法。因此，如果__getitem__()以恒定的访问速度实现时，mixin方法将具有线性性能；但是，如果底层方法是线性的（与链表一样），则mixin将具有二次性能，并且可能需要重写。在 3.5 版更改: index（）方法增加了对 stop 和 开始 参数。
- class collections.abc.MappingView¶
- class collections.abc.ItemsView¶
- class collections.abc.KeysView¶
- class collections.abc.ValuesView¶
映射、项、键和值的ABC views .
- class collections.abc.Awaitable¶
抽象基类 awaitable 对象，可用于
await表达。自定义实现必须提供__await__()方法。Coroutine 的对象和实例
CoroutineABC都是这个ABC的例子。注解
在CPython中，基于生成器的协程（生成器装饰有
types.coroutine()或asyncio.coroutine()是 等待者 即使他们没有__await__()方法。使用isinstance(gencoro, Awaitable)因为他们会回来False. 使用inspect.isawaitable()来检测它们。3.5 新版功能.
- class collections.abc.Coroutine¶
ABC用于协程兼容类。这些方法实现以下方法，在中定义 协程对象 ：
send()，throw()和close(). 自定义实现还必须实现__await__(). 所有Coroutine实例也是Awaitable. 另见定义 coroutine .注解
在CPython中，基于生成器的协程（生成器装饰有
types.coroutine()或asyncio.coroutine()是 等待者 即使他们没有__await__()方法。使用isinstance(gencoro, Coroutine)因为他们会回来False. 使用inspect.isawaitable()来检测它们。3.5 新版功能.
- class collections.abc.AsyncIterable¶
ABC课程提供
__aiter__方法。另见定义 asynchronous iterable .3.5 新版功能.
- class collections.abc.AsyncIterator¶
ABC课程提供
__aiter__和__anext__方法。另见定义 asynchronous iterator .3.5 新版功能.
这些ABC允许我们询问类或实例是否提供特定的功能，例如：
size = None
if isinstance(myvar, collections.abc.Sized):
size = len(myvar)
一些abc还可以作为混合函数使用，这样可以更容易地开发支持容器API的类。例如，编写一个支持 Set API，只需提供三种底层抽象方法： __contains__() ， __iter__() 和 __len__() . ABC提供剩余的方法，如 __and__() 和 isdisjoint() ：：
class ListBasedSet(collections.abc.Set):
''' Alternate set implementation favoring space over speed
and not requiring the set elements to be hashable. '''
def __init__(self, iterable):
self.elements = lst = []
for value in iterable:
if value not in lst:
lst.append(value)
def __iter__(self):
return iter(self.elements)
def __contains__(self, value):
return value in self.elements
def __len__(self):
return len(self.elements)
s1 = ListBasedSet('abcdef')
s2 = ListBasedSet('defghi')
overlap = s1 & s2 # The __and__() method is supported automatically
使用注意事项 Set 和 MutableSet 作为混合：
由于一些集合操作会创建新的集合，因此默认的混合方法需要一种从可迭代对象创建新实例的方法。假定类构造函数具有以下形式的签名
ClassName(iterable)。该假设被分解到一个名为_from_iterable()哪个呼叫cls(iterable)生产一套新的。如果SetMixin正在具有不同构造函数签名的类中使用，您需要重写_from_iterable()使用可以从可迭代参数构造新实例的类方法或常规方法。为了覆盖比较（可能是为了速度，因为语义是固定的），重新定义
__le__()和__ge__()，其他操作将自动跟随。这个
SetMixin提供_hash()方法计算集合的hash值；但是，__hash__()未定义，因为并非所有集都是可hash或不可变的。若要使用mixin添加set hashability，请从两者继承Set()和Hashable()然后定义__hash__ = Set._hash.
参见
OrderedSet recipe 例如，
MutableSet.