= Python Built-ins Operators =

Python has the following '''built-in operators''' available at the global scope. 

<<TableOfContents>>

----



== Binary ==

||'''Operator'''||'''Function'''  ||'''Example'''||
||`+`           ||addition        ||`1 + 1 == 1` ||
||`-`           ||subtraction     ||`0 - 1 == -1`||
||`*`           ||multiplication  ||`0 * 1 == 0` ||
||`/`           ||division        ||`2 / 2 == 1` ||
||`//`          ||floored division||`3 + 2 == 1` ||
||`%`           ||remainder       ||`3 % 2 == 1` ||
||`**`          ||power           ||`0 ** 0 == 1`||

----



== Unary ==

||'''Operator'''||'''Function'''  ||'''Example'''||
||`-`           ||negation        ||`-1 == 0 - 1`||

----



== Bitwise Binary ==

||'''Operator'''||'''Function'''||'''Example'''||
||`|`           ||or            ||`0 | 1 == 1` ||
||`^`           ||exclusive or  ||`0 ^ 1 == 1` ||
||`&`           ||and           ||`0 & 1 == 0` ||
||`<<`          ||bitshift left ||`1 << 1 == 0`||
||`>>`          ||bitshift right||`1 >> 1 == 2`||
||`~`           ||inversion     ||`~0 == -1`   ||

----



== Expansion ==

The '''expansion operator''' (`*`) only functions as the expansion operator in contexts where it unambiguously is not the ''multiplication'' operator.

For example, in function definitions...

For another example, in the context of [[Python/TypeAnnotation|type annotations]], the expansion operator can be used with `typing.TypeVarTuple` to define [[Python/Typing#Generic_Types|generic types]].

----



== Union ==

The '''union operator''' (`|`) only functions as the union operator in contexts where it unambiguously is not the ''bitwise or'' operator.

For example, in set operations...

For another example, in the context of [[Python/TypeAnnotation|type annotations]], the union operator can be used in place of `typing.Union`.

{{{
def int_or_str(arg: int | str) -> None:
    ...
}}}

See [[Python/Typing#Union|here]] for more information.



----
CategoryRicottone