What does the slash(/) in the parameter list of a function mean?
PythonLevel: Intermediate
What does the slash(/) in the parameter list of a function mean?
Hints
- Identify object types, mutability and execution order.
- Trace a minimal example: which values and references change?
Answer
A slash in the argument list of a function denotes that the parameters prior to
it are positional-only. Positional-only parameters are the ones without an
externally usable name. Upon calling a function that accepts positional-only
parameters, arguments are mapped to parameters based solely on their position.
For example, divmod() is a function that accepts positional-only
parameters. Its documentation looks like this:
>>> help(divmod)
Help on built-in function divmod in module builtins:
divmod(x, y, /)
Return the tuple (x//y, x%y). Invariant: div*y + mod == x.
The slash at the end of the parameter list means that both parameters are
positional-only. Thus, calling divmod() with keyword arguments would lead
to an error:
>>> divmod(x=3, y=4)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: divmod() takes no keyword arguments
Source and licence: Python 3.14.0 Programming FAQ — Python Software Foundation · PSF-2.0