10.3. operator
— Operadores padrão como funções¶
Código-fonte: Lib/operator.py
O módulo operator
exporta um conjunto de funções eficientes correspondentes aos operadores intrínsecos do Python. Por exemplo, operator.add(x,y)
é equivalente à expressão x+y
. Muitos nomes de função são aqueles usados para métodos especiais, sem os sublinhados duplos. Para compatibilidade com versões anteriores, muitos deles têm uma variante com os sublinhados duplos mantidos. As variantes sem os sublinhados duplos são preferenciais para maior clareza.
As funções se enquadram em categorias que realizam comparações de objetos, operações lógicas, operações matemáticas e operações de sequência.
As funções de comparação de objetos são úteis para todos os objetos e são nomeadas após os operadores de comparação que os mesmos suportam:
-
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)¶ Executa “comparações ricas” entre a e b. Especialmente,
lt(a, b)
é equivalente aa < b
,le(a, b)
é equivalente aa <= b
,eq(a, b)
é equivalente aa == b
,ne(a, b)
é equivalente aa != b
,gt(a, b)
é equivalente aa > b
ege(a, b)
é equivalente aa >= b
. Observe que essas funções podem retornar qualquer valor, que pode ou não ser interpretável como um valor booleano. Consulte Comparações para obter mais informações sobre comparações ricas. Como as funções de comparação de objetos são úteis para todos os objetos e são nomeados pelos sistemas de comparação.
As operações lógicas também são geralmente aplicáveis a todos os objetos e suportam testes de verdade, testes de identidade e operações booleanas:
-
operator.
not_
(obj)¶ -
operator.
__not__
(obj)¶ Retorna o resultado de
not
obj. (Veja que não existe nenhum método__not__()
para a instância do objetos; apenas o núcleo do interpretador definirá esta operação. O resultado será afetado pelo__bool__()
e__len__()
methods.)
-
operator.
truth
(obj)¶ Retorna
True
se o obj for True, eFalse
caso contrário. Isso é equivalente a utilizar a construçãobool
.
-
operator.
is_
(a, b)¶ Retorna
a is b
. Testa a identidade do objeto.
-
operator.
is_not
(a, b)¶ Retorna
a is not b
. Testa a identidade do objeto.
As operações matemáticas bit a bit são as mais numerosas:
-
operator.
index
(a)¶ -
operator.
__index__
(a)¶ Retorna a convertendo para um inteiro. Equivalente a``a.__index__()``.
-
operator.
inv
(obj)¶ -
operator.
invert
(obj)¶ -
operator.
__inv__
(obj)¶ -
operator.
__invert__
(obj)¶ Retorna o inverso bit a bit do número obj. Isso equivale a
~obj
.
-
operator.
truediv
(a, b)¶ -
operator.
__truediv__
(a, b)¶ Retorna
a / b
onde 2/3 é .66 em vez de 0. Isso também é conhecido como divisão “verdadeira”.
Operações que funcionam com sequências (algumas delas com mapas também) incluem:
-
operator.
contains
(a, b)¶ -
operator.
__contains__
(a, b)¶ Retorna o resultado do teste
b in a
. Observe os operandos invertidos.
-
operator.
countOf
(a, b)¶ Retorna o número de ocorrências de b em a.
-
operator.
indexOf
(a, b)¶ Retorna o índice da primeira ocorrência de b em a.
-
operator.
length_hint
(obj, default=0)¶ Retorna um comprimento estimado para o objeto o. Primeiro tente retornar o seu comprimento real, em seguida, uma estimativa utilizando
object.__length_hint__()
, e finalmente retorna o valor default.Novo na versão 3.4.
O módulo operator
also defines tools for generalized attribute and item lookups. Estes são úteis para fazer extração de campo rapidamente como argumentos para a função map()
, sorted()
, itertools.groupby()
, ou outra função que espera um argumento de função.
-
operator.
attrgetter
(attr)¶ -
operator.
attrgetter
(*attrs) Retorna um objeto invocável que pode buscar o attr do seu operando. Caso seja solicitado mais de um atributo, retorna uma tupla de atributos. Os nomes dos atributos também podem conter pontos. Por exemplo:
Depois de
f = attrgetter('name')
, a chamada af(b)
retornab.name
.Depois de
f = attrgetter('name', 'date')
, a chamada af(b)
retorna``(b.name, b.date)``.Depois de
f = attrgetter('name.first', 'name.last')
, a chamada af(b)
retorna(b.name.first, b.name.last)
.
Equivalente a:
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) Retornar um objeto callable que busca item de seu operando usando o operando do método
__getitem__()
. Se múltiplo itens são especificados, retorna uma tupla de valores da pesquisa. Por exemplo:Depois de
f = itemgetter(2)
, a chamada af(r)
retornar[2]
.Depois de
g = itemgetter(2, 5, 3)
, a chamada ag(r)
retorna(r[2], r[5], r[3])
.
Equivalente a:
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
Os itens podem ser qualquer tipo aceito pelo método
__getitem__()
. Os dicionários aceitam qualquer valor hashable. Listas, tuplas e strings aceitam um índice ou uma fatia:>>> itemgetter(1)('ABCDEFG') 'B' >>> itemgetter(1,3,5)('ABCDEFG') ('B', 'D', 'F') >>> itemgetter(slice(2,None))('ABCDEFG') 'CDEFG'
Exemplo de uso
itemgetter()
para recuperar campos específicos de um registro de tupla:>>> 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...])¶ Retornar um objeto callable que invoca o método name em seu operando. Se argumentos adicionais e/ou argumentos de keyword forem fornecidos, os mesmos serão passados para o método. Por exemplo:
Depois de
f = methodcaller('name')
, a chamada af(b)
retornab.name()
.Depois de
f = methodcaller('name', 'foo', bar=1)
, a chamadaf(b)
retornab.name('foo', bar=1)
.
Equivalente a:
def methodcaller(name, *args, **kwargs): def caller(obj): return getattr(obj, name)(*args, **kwargs) return caller
10.3.1. Mapeando os Operadores para suas Respectivas Funções¶
Esta tabela mostra como as operações abstratos correspondem aos símbolos do operador na sintaxe Python e as funções no módulo operator
.
Operação |
Sintaxe |
Função |
---|---|---|
Adiçao |
|
|
Concatenação |
|
|
Teste de Contenção |
|
|
Divisão |
|
|
Divisão |
|
|
Bitwise And |
|
|
Bitwise Exclusivo Or |
|
|
Bitwise Inversão |
|
|
Bitwise Or |
|
|
Exponenciação |
|
|
Identidade |
|
|
Identidade |
|
|
Atribuição Indexada |
|
|
Eliminação Indexada |
|
|
Indexação |
|
|
Left Shift |
|
|
Módulo |
|
|
Multiplicação |
|
|
Multiplicação de Arrays |
|
|
Negação (Aritmética) |
|
|
Negaçaõ (Logical) |
|
|
Positivo |
|
|
Right Shift |
|
|
Atribuição de Fatiamento |
|
|
Remoção de Fatiamento |
|
|
Fatiamento |
|
|
Formatação de Strings |
|
|
Subtração |
|
|
Teste Verdadeiro |
|
|
Ordenação |
|
|
Ordenação |
|
|
Igualdade |
|
|
Diferença |
|
|
Ordenação |
|
|
Ordenação |
|
|
10.3.2. Operadores Inplace¶
Muitas operações possuem uma versão “in-place”. Listadas abaixo, as funções fornecem um acesso mais primitivo as operadores locais do que a sintaxe usual; por exemplo, o termo statement x += y
é equivalente a x = operator.iadd(x, y)
. Outra maneira de colocá-lo é dizendo que z = operator.iadd(x, y)
é equivalente à instrução composta z = x; z += y
.
Nesses exemplos, note que, quando um método in-place é invocado, a computação e a atribuição são realizadas em duas etapas separadas. As funções in-lace listadas abaixo apenas fazem o primeiro passo, invocando o método in-place. O segundo passo, a atribuição, não é tratado.
Para os casos imutáveis, como as Strings, números e tuplas, o valor atualizado será calculado, mas não será atribuído de volta à variável de entrada:
>>> a = 'hello'
>>> iadd(a, ' world')
'hello world'
>>> a
'hello'
Para os casos mutáveis, como listas e dicionários, o método de in-place irá executar a atualização, portanto, nenhuma atribuição subsequente será necessária:
>>> 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.
iconcat
(a, b)¶ -
operator.
__iconcat__
(a, b)¶ a = iconcat(a, b)
é equivalente aa += b
onde a e b são sequências.
-
operator.
ifloordiv
(a, b)¶ -
operator.
__ifloordiv__
(a, b)¶ a = ifloordiv(a, b)
é equivalente aa //= b
.