Pythonoperator标准运算符替代函数
源代码: Lib/operator.py
operator
模块提供了一套与Python的内置运算符对应的高效率函数。例如,operator.add(x,y)
与表达式 x+y
相同。 许多函数名与特殊方法名相同,只是没有双下划线。为了向后兼容性,也保留了许多包含双下划线的函数。为了表述清楚,建议使用没有双下划线的函数。
函数包含的种类有:对象的比较运算、逻辑运算、数学运算以及序列运算。
对象比较函数适用于所有的对象,函数名根据它们对应的比较运算符命名。
operator.
lt
(a, b)¶operator.
le
(a, b)¶operator.
eq
(a, b)¶operator.
ne
(a, b)¶operator.
ge
(a, b)¶operator.
gt
(a, b)¶operator.
__lt__
(a, b)¶operator.
__le__
(a, b)¶operator.
__eq__
(a, b)¶operator.
__ne__
(a, b)¶operator.
__ge__
(a, b)¶operator.
__gt__
(a, b)¶在 a 和 b 之间进行全比较。具体的,
lt(a,b)
与a<b
相同,le(a,b)
与a<=b
相同,eq(a,b)
与a==b
相同,ne(a,b)
与a!=b
相同,gt(a,b)
与a>b
相同,ge(a,b)``与``a>=b
相同。注意这些函数可以返回任何值,无论它是否可当作布尔值。关于全比较的更多信息请参考 比较运算 。
逻辑运算通常也适用于所有对象,并且支持真值检测、标识检测和布尔运算:
operator.
not_
(obj)¶operator.
__not__
(obj)¶返回
not
obj 的结果。 (请注意对象实例并没有__not__()
方法;只有解释器核心可定义此操作。 结果会受__bool__()
和__len__()
方法影响。)
operator.
truth
(obj)¶如果 obj 为真值则返回
True
,否则返回False
。 这等价于使用bool
构造器。
operator.
is_
(a, b)¶返回
aisb
. 测试对象标识。
operator.
is_not
(a, b)¶返回
aisnotb
. 测试对象标识。
数学和按位运算的种类是最多的:
operator.
abs
(obj)¶operator.
__abs__
(obj)¶返回 obj 的绝对值。
operator.
add
(a, b)¶operator.
__add__
(a, b)¶对于数字 a 和 b,返回
a+b
。
operator.
and_
(a, b)¶operator.
__and__
(a, b)¶返回 x 和 y 按位与
operator.
floordiv
(a, b)¶operator.
__floordiv__
(a, b)¶返回
a//b
.
operator.
index
(a)¶operator.
__index__
(a)¶返回 a 转换为整数的结果。 等价于
a.__index__()
。
operator.
inv
(obj)¶operator.
invert
(obj)¶operator.
__inv__
(obj)¶operator.
__invert__
(obj)¶返回数字 obj 按位取反的结果。 这等价于
~obj
。
operator.
lshift
(a, b)¶operator.
__lshift__
(a, b)¶返回 a 左移 b 位的结果。
operator.
mod
(a, b)¶operator.
__mod__
(a, b)¶返回
a%b
.
operator.
mul
(a, b)¶operator.
__mul__
(a, b)¶对于数字 a 和 b,返回
a*b
。
operator.
matmul
(a, b)¶operator.
__matmul__
(a, b)¶返回
a@b
.3.5 新版功能.
operator.
neg
(obj)¶operator.
__neg__
(obj)¶返回 obj 的负值 (
-obj
)。
operator.
or_
(a, b)¶operator.
__or__
(a, b)¶返回 a 和 b 按位或的结果。
operator.
pos
(obj)¶operator.
__pos__
(obj)¶返回 obj 取正的结果 (
+obj
)。
operator.
pow
(a, b)¶operator.
__pow__
(a, b)¶对于数字 a 和 b,返回
a**b
。
operator.
rshift
(a, b)¶operator.
__rshift__
(a, b)¶返回 a 右移 b 位的结果。
operator.
sub
(a, b)¶operator.
__sub__
(a, b)¶返回
a-b
.
operator.
truediv
(a, b)¶operator.
__truediv__
(a, b)¶返回
a/b
例如 2/3 将等于 .66 而不是 0。 这也被称为“真”除法。
operator.
xor
(a, b)¶operator.
__xor__
(a, b)¶返回 a 和 b 按位异或的结果。
适用于序列的操作(其中一些也适用于映射)包括:
operator.
concat
(a, b)¶operator.
__concat__
(a, b)¶对于序列 a 和 b,返回
a+b
。
operator.
contains
(a, b)¶operator.
__contains__
(a, b)¶返回
bina
检测的结果。 请注意操作数是反序的。
operator.
countOf
(a, b)¶返回 b 在 a 中的出现次数。
operator.
delitem
(a, b)¶operator.
__delitem__
(a, b)¶移除 a 中索引号为 b 的值。
operator.
getitem
(a, b)¶operator.
__getitem__
(a, b)¶返回 a 中索引为 b 的值。
operator.
indexOf
(a, b)¶返回 b 在 a 中首次出现所在的索引号。
operator.
setitem
(a, b, c)¶operator.
__setitem__
(a, b, c)¶将 a 中索引号为 b 的值设为 c。
operator.
length_hint
(obj, default=0)¶返回对象 o 的估计长度。 首先尝试返回其实际长度,再使用
object.__length_hint__()
得出估计值,最后返回默认值。3.4 新版功能.
operator
模块还定义了一些用于常规属性和条目查找的工具。 这些工具适合用来编写快速字段提取器作为 map()
, sorted()
, itertools.groupby()
或其他需要相应函数参数的函数的参数。
operator.
attrgetter
(attr)¶operator.
attrgetter
(*attrs)返回一个可从操作数中获取 attr 的可调用对象。 如果请求了一个以上的属性,则返回一个属性元组。 属性名称还可包含点号。 例如:
在
f=attrgetter('name')
之后,调用f(b)
将返回b.name
。在
f=attrgetter('name','date')
之后,调用f(b)
将返回(b.name,b.date)
。在
f=attrgetter('name.first','name.last')
之后,调用f(b)
将返回(b.name.first,b.name.last)
。
等价于:
python3 notranslate">defattrgetter(*items):
ifany(notisinstance(item,str)foriteminitems):
raiseTypeError('attribute name must be a string')
iflen(items)==1:
attr=items[0]
defg(obj):
returnresolve_attr(obj,attr)
else:
defg(obj):
returntuple(resolve_attr(obj,attr)forattrinitems)
returng
defresolve_attr(obj,attr):
fornameinattr.split("."):
obj=getattr(obj,name)
returnobj
operator.
itemgetter
(item)¶operator.
itemgetter
(*items)返回一个使用操作数的
__getitem__()
方法从操作数中获取 item 的可调用对象。 如果指定了多个条目,则返回一个查找值的元组。 例如:在
f=itemgetter(2)
之后,调用f(r)
将返回r[2]
。在
g=itemgetter(2,5,3)
之后,调用g(r)
将返回(r[2],r[5],r[3])
。
等价于:
python3 notranslate">defitemgetter(*items):
iflen(items)==1:
item=items[0]
defg(obj):
returnobj[item]
else:
defg(obj):
returntuple(obj[item]foriteminitems)
returng
传入的条目可以为操作数的
__getitem__()
所接受的任何类型。 字典接受任意可哈希的值。 列表、元组和字符串接受 index 或 slice 对象:>>> itemgetter(1)('ABCDEFG')
'B'
>>> itemgetter(1,3,5)('ABCDEFG')
('B', 'D', 'F')
>>> itemgetter(slice(2,None))('ABCDEFG')
'CDEFG'
>>> soldier=dict(rank='captain',name='dotterbart')
>>> itemgetter('rank')(soldier)
'captain'
使用
itemgetter()
从元组的记录中提取特定字段的例子:>>> inventory=[('apple',3),('banana',2),('pear',5),('orange',1)]
>>> getcount=itemgetter(1)
>>> list(map(getcount,inventory))
[3, 2, 5, 1]
>>> sorted(inventory,key=getcount)
[('orange', 1), ('banana', 2), ('apple', 3), ('pear', 5)]
operator.
methodcaller
(name[, args...])¶返回一个在操作数上调用 name 方法的可调用对象。 如果给出额外的参数和/或关键字参数,它们也将被传给该方法。 例如:
在
f=methodcaller('name')
之后,调用f(b)
将返回b.name()
。在
f=methodcaller('name','foo',bar=1)
之后,调用f(b)
将返回b.name('foo',bar=1)
。
等价于:
defmethodcaller(name,*args,**kwargs):
defcaller(obj):
returngetattr(obj,name)(*args,**kwargs)
returncaller
将运算符映射到函数¶
以下表格显示了抽象运算是如何对应于 Python 语法中的运算符和 operator
模块中的函数的。
运算 | 语法 | 函数 |
---|---|---|
加法 |
|
|
字符串拼接 |
|
|
包含测试 |
|
|
除法 |
|
|
除法 |
|
|
按位与 |
|
|
按位异或 |
|
|
按位取反 |
|
|
按位或 |
|
|
取幂 |
|
|
一致 |
|
|
一致 |
|
|
索引赋值 |
|
|
索引删除 |
|
|
索引取值 |
|
|
左移 |
|
|
取模 |
|
|
乘法 |
|
|
矩阵乘法 |
|
|
否定(算术) |
|
|
否定(逻辑) |
|
|
正数 |
|
|
右移 |
|
|
切片赋值 |
|
|
切片删除 |
|
|
切片取值 |
|
|
字符串格式化 |
|
|
减法 |
|
|
真值测试 |
|
|
比较 |
|
|
比较 |
|
|
相等 |
|
|
不等 |
|
|
比较 |
|
|
比较 |
|
|
原地操作¶
许多运算都有“原地”版本。 以下列出的是提供对原地运算符相比通常语法更底层访问的函数,例如 statementx+=y
相当于 x=operator.iadd(x,y)
。 换一种方式来讲就是 z=operator.iadd(x,y)
等价于语句块 z=x;z+=y
。
在这些例子中,请注意当调用一个原地方法时,运算和赋值是分成两个步骤来执行的。 下面列出的原地函数只执行第一步即调用原地方法。 第二步赋值则不加处理。
对于不可变的目标例如字符串、数字和元组,更新的值会被计算,但不会被再被赋值给输入变量:
>>> a='hello'>>> iadd(a,' world')
'hello world'
>>> a
'hello'
对于可变的目标例如列表和字典,原地方法将执行更新,因此不需要后续赋值操作:
>>> s=['h','e','l','l','o']>>> iadd(s,[' ','w','o','r','l','d'])
['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
>>> s
['h', 'e', 'l', 'l', 'o', ' ', 'w', 'o', 'r', 'l', 'd']
operator.
iadd
(a, b)¶operator.
__iadd__
(a, b)¶a=iadd(a,b)
等价于a+=b
。
operator.
iand
(a, b)¶operator.
__iand__
(a, b)¶a=iand(a,b)
等价于a&=b
。
operator.
iconcat
(a, b)¶operator.
__iconcat__
(a, b)¶a=iconcat(a,b)
等价于a+=b
其中 a 和 b 为序列。
operator.
ifloordiv
(a, b)¶operator.
__ifloordiv__
(a, b)¶a=ifloordiv(a,b)
等价于a//=b
.
operator.
ilshift
(a, b)¶operator.
__ilshift__
(a, b)¶a=ilshift(a,b)
等价于a<<=b
。
operator.
imod
(a, b)¶operator.
__imod__
(a, b)¶a=imod(a,b)
等价于a%=b
。
operator.
imul
(a, b)¶operator.
__imul__
(a, b)¶a=imul(a,b)
等价于a*=b
。
operator.
imatmul
(a, b)¶operator.
__imatmul__
(a, b)¶a=imatmul(a,b)
等价于a@=b
。3.5 新版功能.
operator.
ior
(a, b)¶operator.
__ior__
(a, b)¶a=ior(a,b)
等价于a|=b
。
operator.
ipow
(a, b)¶operator.
__ipow__
(a, b)¶a=ipow(a,b)
等价于a**=b
。
operator.
irshift
(a, b)¶operator.
__irshift__
(a, b)¶a=irshift(a,b)
等价于a>>=b
。
operator.
isub
(a, b)¶operator.
__isub__
(a, b)¶a=isub(a,b)
等价于a-=b
。
operator.
itruediv
(a, b)¶operator.
__itruediv__
(a, b)¶a=itruediv(a,b)
等价于a/=b
。
operator.
ixor
(a, b)¶operator.
__ixor__
(a, b)¶a=ixor(a,b)
等价于a^=b
。