import collections as col

# namedtuple(具名元组/命名元组的工厂函数)
City = col.namedtuple('City', 'name country')  # 用标准库collections中的namedtuple函数创建具名元组
# 其中“‘City’”是类名，后者是类的各个字段名

Beijing = City('Beijing', 'China')
print(Beijing)
Shanghai = City('Shanghai', 'China')
print(Shanghai)

print(Beijing.name)
print(Shanghai.country)
print(Beijing[0])
print(Shanghai[1])

Point = col.namedtuple('Point', ['x', 'y'])

p = [1, 2]
print(Point._make(p))  # _make()接受一个可迭代对象创建新的命名元组
print(Point._fields)  # _fields方法会返回一个包含"Point"类里所有字段的元组

p = Point(1, 2)
print(p._asdict())  # 返回一个OrderedDict，它能友好地呈现出元组里的信息
print(p._replace(x=2))  # 返回一个新的命名元组实例，并将指定字段的值替换为新的值
print(p)  # _replace()返回的是新的命名元组实例，所以p不会改变

p2 = {'x': 1, 'y': 2}
print(Point(**p2))  # 将字典转化为命名元组

# Counter(计数器)
a = col.Counter('aaabbcdddd')  # 统计'aaabbcdddd'(可迭代对象)里字母出现的次数并创建对应的字典(按次数大小排列)
print(a)

b = col.Counter()
print(b)  # 空的计数器

c = col.Counter({'a': 3, 'b': 2, 'c': 3, 'd': 4})  # 根据字典创建计数器
print(c)

d = col.Counter(a=3, b=2, c=1, d=4)  # 根据键值创建
print(d)

e = col.Counter(['a', 'a', 'b'])
print(e['a'])  # 统计列表中'a'出现的次数
print(e['c'])  # 如果没有相应的键就返回零

# elements()函数会返回一个迭代器
f = col.Counter(a=2, b=1, c=0, d=-1)  # elements()函数会忽略计数值小于1的元素
print(sorted(f.elements()))  # 迭代器不能直接打印，需要先用sorted()函数新建一个列表

# most_common([n])返回一个包含n个最常见的元素及出现次数的列表
g = col.Counter('aaabbcdddd')
print(g.most_common(2))  # 结果:[('d', 4), ('a', 3)]
print(g.most_common())  # 如果不传参或传"None",将返回计数器中的所有元素
print(g.most_common(None))