8.3. Builtin Library

• https://docs.python.org/library/operator.html

• The operator module exports a set of efficient functions corresponding to the intrinsic operators of Python.

• For example, operator.add(x, y) is equivalent to the expression x+y.

• Many function names are those used for special methods, without the double underscores.

• For backward compatibility, many of these have a variant with the double underscores kept.

• The variants without the double underscores are preferred for clarity.

8.3.1. Mapping Operators to Functions

Operation	Syntax	Function
Addition	a + b	add(a, b)
Concatenation	seq1 + seq2	concat(seq1, seq2)
Containment Test	obj in seq	contains(seq, obj)
Division	a / b	truediv(a, b)
Division	a // b	floordiv(a, b)
Bitwise And	a & b	and_(a, b)
Bitwise Exclusive Or	a ^ b	xor(a, b)
Bitwise Inversion	~ a	invert(a)
Bitwise Or	a | b	or_(a, b)
Exponentiation	a ** b	pow(a, b)
Identity	a is b	is_(a, b)
Identity	a is not b	is_not(a, b)
Indexed Assignment	obj[k] = v	setitem(obj, k, v)
Indexed Deletion	del obj[k]	delitem(obj, k)
Indexing	obj[k]	getitem(obj, k)
Left Shift	a << b	lshift(a, b)
Modulo	a % b	mod(a, b)
Multiplication	a * b	mul(a, b)
Matrix Multiplication	a @ b	matmul(a, b)
Negation (Arithmetic)	- a	neg(a)
Negation (Logical)	not a	not_(a)
Positive	+ a	pos(a)
Right Shift	a >> b	rshift(a, b)
Slice Assignment	seq[i:j] = values	setitem(seq, slice(i, j), values)
Slice Deletion	del seq[i:j]	delitem(seq, slice(i, j))
Slicing	seq[i:j]	getitem(seq, slice(i, j))
String Formatting	s % obj	mod(s, obj)
Subtraction	a - b	sub(a, b)
Truth Test	obj	truth(obj)
Ordering	a < b	lt(a, b)
Ordering	a <= b	le(a, b)
Equality	a == b	eq(a, b)
Difference	a != b	ne(a, b)
Ordering	a >= b	ge(a, b)
Ordering	a > b	gt(a, b)

8.3.2. Comparison

• 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.not_(obj)

• operator.truth(obj)

• operator.is_(a, b)

• operator.is_not(a, b)

• operator.abs(obj)

• operator.add(a, b)

• operator.and_(a, b)

• operator.floordiv(a, b)

• operator.index(a)

• operator.invert(obj) or operator.inv(obj)

• operator.lshift(a, b)

• operator.mod(a, b)

• operator.mul(a, b)

• operator.matmul(a, b)

• operator.neg(obj)

• operator.or_(a, b)

• operator.pos(obj)

• operator.pow(a, b)

• operator.rshift(a, b)

• operator.sub(a, b)

• operator.truediv(a, b)

• operator.xor(a, b)

• operator.concat(a, b)

• operator.contains(a, b)

• operator.countOf(a, b)

• operator.delitem(a, b)

• operator.getitem(a, b)

• operator.indexOf(a, b)

• operator.setitem(a, b, c)

• operator.length_hint(obj, default=0)

• operator.attrgetter(attr) or operator.attrgetter(*attrs)

• operator.itemgetter(item) or operator.itemgetter(*items)

• operator.methodcaller(name, /, *args, **kwargs)

8.3.3. In-place Operators

• operator.iadd(a, b)

• operator.iand(a, b)

• operator.iconcat(a, b)

• operator.ifloordiv(a, b)

• operator.ilshift(a, b)

• operator.imod(a, b)

• operator.imul(a, b)

• operator.imatmul(a, b)

• operator.ior(a, b)

• operator.ipow(a, b)

• operator.irshift(a, b)

• operator.isub(a, b)

• operator.itruediv(a, b)

• operator.ixor(a, b)