12.14. Idiom Min

  • min(iterable, *, key=None)

  • min(iterable, *, default, key=None)

  • min(arg1, arg2, *args, key=None)

If one positional argument is provided, it should be an iterable. The smallest item in the iterable is returned. If two or more positional arguments are provided, the smallest of the positional arguments is returned.

There are two optional keyword-only arguments. The key argument specifies a one-argument ordering function like that used for list.sort(). The default argument specifies an object to return if the provided iterable is empty. If the iterable is empty and default is not provided, a ValueError is raised. [1]

12.14.1. References