`operator` --- 標(biāo)準(zhǔn)運(yùn)算符替代函數(shù)?

源代碼: Lib/operator.py

operator 模塊提供了一套與Python的內(nèi)置運(yùn)算符對(duì)應(yīng)的高效率函數(shù)。例如，operator.add(x, y) 與表達(dá)式 x+y 相同。許多函數(shù)名與特殊方法名相同，只是沒有雙下劃線。為了向后兼容性，也保留了許多包含雙下劃線的函數(shù)。為了表述清楚，建議使用沒有雙下劃線的函數(shù)。

函數(shù)包含的種類有：對(duì)象的比較運(yùn)算、邏輯運(yùn)算、數(shù)學(xué)運(yùn)算以及序列運(yùn)算。

對(duì)象比較函數(shù)適用于所有的對(duì)象，函數(shù)名根據(jù)它們對(duì)應(yīng)的比較運(yùn)算符命名。

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 之間進(jìn)行全比較。具體的，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 相同。注意這些函數(shù)可以返回任何值，無論它是否可當(dāng)作布爾值。關(guān)于全比較的更多信息請(qǐng)參考比較運(yùn)算。

邏輯運(yùn)算通常也適用于所有對(duì)象，并且支持真值檢測(cè)、標(biāo)識(shí)檢測(cè)和布爾運(yùn)算：

operator.not_(obj)?
operator.__not__(obj)?: 返回 not obj 的結(jié)果。（請(qǐng)注意對(duì)象實(shí)例并沒有 __not__() 方法；只有解釋器核心可定義此操作。結(jié)果會(huì)受 __bool__() 和 __len__() 方法影響。）

operator.truth(obj)?: 如果 obj 為真值則返回 True，否則返回 False。這等價(jià)于使用 bool 構(gòu)造器。

operator.is_(a, b)?: 返回 a is b。檢測(cè)對(duì)象標(biāo)識(shí)。

operator.is_not(a, b)?: 返回 a is not b。檢測(cè)對(duì)象標(biāo)識(shí)。

數(shù)學(xué)和按位運(yùn)算的種類是最多的：

operator.abs(obj)?
operator.__abs__(obj)?: 返回 obj 的絕對(duì)值。

operator.add(a, b)?
operator.__add__(a, b)?: 對(duì)于數(shù)字 a 和 b，返回 a + b。

operator.and_(a, b)?
operator.__and__(a, b)?: 返回 x 和 y 按位與的結(jié)果。

operator.floordiv(a, b)?
operator.__floordiv__(a, b)?: 返回 a // b。

operator.index(a)?
operator.__index__(a)?: 返回 a 轉(zhuǎn)換為整數(shù)的結(jié)果。等價(jià)于 a.__index__()。

在 3.10 版更改: 結(jié)果總是為 int 類型。在之前版本中，結(jié)果可能為 int 的子類的實(shí)例。

operator.inv(obj)?
operator.invert(obj)?
operator.__inv__(obj)?
operator.__invert__(obj)?: 返回?cái)?shù)字 obj 按位取反的結(jié)果。這等價(jià)于 ~obj。

operator.lshift(a, b)?
operator.__lshift__(a, b)?: 返回 a 左移 b 位的結(jié)果。

operator.mod(a, b)?
operator.__mod__(a, b)?: 返回 a % b。

operator.mul(a, b)?
operator.__mul__(a, b)?: 對(duì)于數(shù)字 a 和 b，返回 a * b。

operator.matmul(a, b)?
operator.__matmul__(a, b)?: 返回 a @ b。

3.5 新版功能.

operator.neg(obj)?
operator.__neg__(obj)?: 返回 obj 取負(fù)的結(jié)果 (-obj)。

operator.or_(a, b)?
operator.__or__(a, b)?: 返回 a 和 b 按位或的結(jié)果。

operator.pos(obj)?
operator.__pos__(obj)?: 返回 obj 取正的結(jié)果 (+obj)。

operator.pow(a, b)?
operator.__pow__(a, b)?: 對(duì)于數(shù)字 a 和 b，返回 a ** b。

operator.rshift(a, b)?
operator.__rshift__(a, b)?: 返回 a 右移 b 位的結(jié)果。

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 按位異或的結(jié)果。

適用于序列的操作（其中一些也適用于映射）包括：

operator.concat(a, b)?
operator.__concat__(a, b)?: 對(duì)于序列 a 和 b，返回 a + b。

operator.contains(a, b)?
operator.__contains__(a, b)?: 返回 b in a 檢測(cè)的結(jié)果。請(qǐng)注意操作數(shù)是反序的。

operator.countOf(a, b)?: 返回 b 在 a 中的出現(xiàn)次數(shù)。

operator.delitem(a, b)?
operator.__delitem__(a, b)?: 移除 a 中索引號(hào)為 b 的值。

operator.getitem(a, b)?
operator.__getitem__(a, b)?: 返回 a 中索引為 b 的值。

operator.indexOf(a, b)?: 返回 b 在 a 中首次出現(xiàn)所在的索引號(hào)。

operator.setitem(a, b, c)?
operator.__setitem__(a, b, c)?: 將 a 中索引號(hào)為 b 的值設(shè)為 c。

operator.length_hint(obj, default=0)?: 返回對(duì)象 o 的估計(jì)長(zhǎng)度。首先嘗試返回其實(shí)際長(zhǎng)度，再使用 object.__length_hint__() 得出估計(jì)值，最后返回默認(rèn)值。

3.4 新版功能.

The following operation works with callables:

operator.call(obj, /, *args, **kwargs)?
operator.__call__(obj, /, *args, **kwargs)?: Return obj(*args, **kwargs).

3.11 新版功能.

operator 模塊還定義了一些用于常規(guī)屬性和條目查找的工具。這些工具適合用來編寫快速字段提取器作為 map(), sorted(), itertools.groupby() 或其他需要相應(yīng)函數(shù)參數(shù)的函數(shù)的參數(shù)。

operator.attrgetter(attr)?

operator.attrgetter(*attrs)

返回一個(gè)可從操作數(shù)中獲取 attr 的可調(diào)用對(duì)象。如果請(qǐng)求了一個(gè)以上的屬性，則返回一個(gè)屬性元組。屬性名稱還可包含點(diǎn)號(hào)。例如：

在 f = attrgetter('name') 之后，調(diào)用 f(b) 將返回 b.name。
在 f = attrgetter('name', 'date') 之后，調(diào)用 f(b) 將返回 (b.name, b.date)。
在 f = attrgetter('name.first', 'name.last') 之后，調(diào)用 f(b) 將返回 (b.name.first, b.name.last)。

等價(jià)于:

def attrgetter(*items):
    if any(not isinstance(item, str) for item in items):
        raise TypeError('attribute name must be a string')
    if len(items) == 1:
        attr = items[0]
        def g(obj):
            return resolve_attr(obj, attr)
    else:
        def g(obj):
            return tuple(resolve_attr(obj, attr) for attr in items)
    return g

def resolve_attr(obj, attr):
    for name in attr.split("."):
        obj = getattr(obj, name)
    return obj

operator.itemgetter(item)?

operator.itemgetter(*items)

返回一個(gè)使用操作數(shù)的 __getitem__() 方法從操作數(shù)中獲取 item 的可調(diào)用對(duì)象。如果指定了多個(gè)條目，則返回一個(gè)查找值的元組。例如：

在 f = itemgetter(2) 之后，調(diào)用 f(r) 將返回 r[2]。
在 g = itemgetter(2, 5, 3) 之后，調(diào)用 g(r) 將返回 (r[2], r[5], r[3])。

等價(jià)于:

def itemgetter(*items):
    if len(items) == 1:
        item = items[0]
        def g(obj):
            return obj[item]
    else:
        def g(obj):
            return tuple(obj[item] for item in items)
    return g

傳入的條目可以為操作數(shù)的 __getitem__() 所接受的任何類型。字典接受任意可哈希的值。列表、元組和字符串接受 index 或 slice 對(duì)象：

>>>>>> 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, **kwargs)?

返回一個(gè)在操作數(shù)上調(diào)用 name 方法的可調(diào)用對(duì)象。如果給出額外的參數(shù)和/或關(guān)鍵字參數(shù)，它們也將被傳給該方法。例如：

在 f = methodcaller('name') 之后，調(diào)用 f(b) 將返回 b.name()。
在 f = methodcaller('name', 'foo', bar=1) 之后，調(diào)用 f(b) 將返回 b.name('foo', bar=1)。

等價(jià)于:

def methodcaller(name, /, *args, **kwargs):
    def caller(obj):
        return getattr(obj, name)(*args, **kwargs)
    return caller

將運(yùn)算符映射到函數(shù)?

以下表格顯示了抽象運(yùn)算是如何對(duì)應(yīng)于 Python 語法中的運(yùn)算符和 operator 模塊中的函數(shù)的。

運(yùn)算	語法	函數(shù)
加法	`a + b`	`add(a, b)`
字符串拼接	`seq1 + seq2`	`concat(seq1, seq2)`
包含測(cè)試	`obj in seq`	`contains(seq, obj)`
除法	`a / b`	`truediv(a, b)`
除法	`a // b`	`floordiv(a, b)`
按位與	`a & b`	`and_(a, b)`
按位異或	`a ^ b`	`xor(a, b)`
按位取反	`~ a`	`invert(a)`
按位或	`a \| b`	`or_(a, b)`
取冪	`a ** b`	`pow(a, b)`
標(biāo)識(shí)	`a is b`	`is_(a, b)`
標(biāo)識(shí)	`a is not b`	`is_not(a, b)`
索引賦值	`obj[k] = v`	`setitem(obj, k, v)`
索引刪除	`del obj[k]`	`delitem(obj, k)`
索引取值	`obj[k]`	`getitem(obj, k)`
左移	`a << b`	`lshift(a, b)`
取模	`a % b`	`mod(a, b)`
乘法	`a * b`	`mul(a, b)`
矩陣乘法	`a @ b`	`matmul(a, b)`
取反（算術(shù)）	`- a`	`neg(a)`
取反（邏輯）	`not a`	`not_(a)`
正數(shù)	`+ a`	`pos(a)`
右移	`a >> b`	`rshift(a, b)`
切片賦值	`seq[i:j] = values`	`setitem(seq, slice(i, j), values)`
切片刪除	`del seq[i:j]`	`delitem(seq, slice(i, j))`
切片取值	`seq[i:j]`	`getitem(seq, slice(i, j))`
字符串格式化	`s % obj`	`mod(s, obj)`
減法	`a - b`	`sub(a, b)`
真值測(cè)試	`obj`	`truth(obj)`
比較	`a < b`	`lt(a, b)`
比較	`a <= b`	`le(a, b)`
相等	`a == b`	`eq(a, b)`
不等	`a != b`	`ne(a, b)`
比較	`a >= b`	`ge(a, b)`
比較	`a > b`	`gt(a, b)`

原地運(yùn)算符?

許多運(yùn)算都有“原地”版本。以下列出的是提供對(duì)原地運(yùn)算符相比通常語法更底層訪問的函數(shù)，例如 statement x += y 相當(dāng)于 x = operator.iadd(x, y)。換一種方式來講就是 z = operator.iadd(x, y) 等價(jià)于語句塊 z = x; z += y。

在這些例子中，請(qǐng)注意當(dāng)調(diào)用一個(gè)原地方法時(shí)，運(yùn)算和賦值是分成兩個(gè)步驟來執(zhí)行的。下面列出的原地函數(shù)只執(zhí)行第一步即調(diào)用原地方法。第二步賦值則不加處理。

對(duì)于不可變的目標(biāo)例如字符串、數(shù)字和元組，更新的值會(huì)被計(jì)算，但不會(huì)被再被賦值給輸入變量：

>>>>>> a = 'hello'
>>> iadd(a, ' world')
'hello world'
>>> a
'hello'

對(duì)于可變的目標(biāo)例如列表和字典，原地方法將執(zhí)行更新，因此不需要后續(xù)賦值操作：

>>>>>> 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) 等價(jià)于 a += b。

operator.iand(a, b)?
operator.__iand__(a, b)?: a = iand(a, b) 等價(jià)于 a &= b。

operator.iconcat(a, b)?
operator.__iconcat__(a, b)?: a = iconcat(a, b) 等價(jià)于 a += b 其中 a 和 b 為序列。

operator.ifloordiv(a, b)?
operator.__ifloordiv__(a, b)?: a = ifloordiv(a, b) 等價(jià)于 a //= b。

operator.ilshift(a, b)?
operator.__ilshift__(a, b)?: a = ilshift(a, b) 等價(jià)于 a <<= b。

operator.imod(a, b)?
operator.__imod__(a, b)?: a = imod(a, b) 等價(jià)于 a %= b。

operator.imul(a, b)?
operator.__imul__(a, b)?: a = imul(a, b) 等價(jià)于 a *= b。

operator.imatmul(a, b)?
operator.__imatmul__(a, b)?: a = imatmul(a, b) 等價(jià)于 a @= b。

3.5 新版功能.

operator.ior(a, b)?
operator.__ior__(a, b)?: a = ior(a, b) 等價(jià)于 a |= b。

operator.ipow(a, b)?
operator.__ipow__(a, b)?: a = ipow(a, b) 等價(jià)于 a **= b。

operator.irshift(a, b)?
operator.__irshift__(a, b)?: a = irshift(a, b) 等價(jià)于 a >>= b。

operator.isub(a, b)?
operator.__isub__(a, b)?: a = isub(a, b) 等價(jià)于 a -= b。

operator.itruediv(a, b)?
operator.__itruediv__(a, b)?: a = itruediv(a, b) 等價(jià)于 a /= b。

operator.ixor(a, b)?
operator.__ixor__(a, b)?: a = ixor(a, b) 等價(jià)于 a ^= b。

`operator` --- 標(biāo)準(zhǔn)運(yùn)算符替代函數(shù)?

將運(yùn)算符映射到函數(shù)?

原地運(yùn)算符?

目錄

上一個(gè)主題

下一個(gè)主題

當(dāng)前頁面

operator --- 標(biāo)準(zhǔn)運(yùn)算符替代函數(shù)?

將運(yùn)算符映射到函數(shù)?

原地運(yùn)算符?

`operator` --- 標(biāo)準(zhǔn)運(yùn)算符替代函數(shù)?