Python min() Function - Learn By Example

Returns the smallest item

Usage

The min() function can find

the smallest of two or more values (such as numbers, strings etc.)
the smallest item in an iterable (such as list, tuple etc.)

With optional key parameter, you can specify custom comparison criteria to find minimum value.

Syntax

min(val1,val2,val3… ,key)

Python min() function parameters
Parameter	Condition	Description
val1,val2,val3…	Required	Two or more values to compare
key	Optional	A function to specify the comparison criteria. Default value is None.

– OR –

min(iterable,key,default)

Python min() function parameters
Parameter	Condition	Description
iterable	Required	Any iterable, with one or more items to compare
key	Optional	A function to specify the comparison criteria. Default value is None.
default	Optional	A value to return if the iterable is empty. Default value is False.

Find Minimum of Two or More Values

If you specify two or more values, the smallest value is returned.

x = min(10, 20, 30)
print(x)
# Prints 10

If the values are strings, the string with the lowest value in alphabetical order is returned.

x = min('red', 'green', 'blue')
print(x)
# Prints blue

You have to specify minimum two values to compare. Otherwise, TypeError exception is raised.

Find Minimum in an Iterable

If you specify an Iterable (such as list, tuple, set etc.), the smallest item in that iterable is returned.

L = [300, 500, 100, 400, 200]
x = min(L)
print(x)
# Prints 100

If the iterable is empty, a ValueError is raised.

L = []
x = min(L)
print(x)
# Triggers ValueError: min() arg is an empty sequence

To avoid such exception, add default parameter. The default parameter specifies a value to return if the provided iterable is empty.

# Specify default value '0'
L = []
x = min(L, default='0')
print(x)
# Prints 0

Find Minimum with Built-in Function

With optional key parameter, you can specify custom comparison criteria to find minimum value. A key parameter specifies a function to be executed on each iterable’s item before making comparisons.

For example, with a list of strings, specifying key=len (the built-in len() function) finds shortest string.

L = ['red', 'green', 'blue']
x = min(L, key=len)
print(x)
# Prints red

Find Minimum with Custom Function

You can also pass in your own custom function as the key function.

# Find out who is the youngest student
def myFunc(e):
  return e[1]	# return age

L = [('Sam', 35),
    ('Tom', 25),
    ('Bob', 30)]

x = min(L, key=myFunc)
print(x)
# Prints ('Tom', 25)

A key function takes a single argument and returns a key to use for comparison.

Find Minimum with lambda

A key function may also be created with the lambda expression. It allows us to in-line function definition.

# Find out who is the youngest student
L = [('Sam', 35),
    ('Tom', 25),
    ('Bob', 30)]

x = min(L, key=lambda student: student[1])
print(x)
# Prints ('Tom', 25)

Find Minimum of Custom Objects

Let’s create a list of students (custom object) and find out who is the youngest student.

# Custom class
class Student:
	def __init__(self, name, age):
		self.name = name
		self.age = age
	def __repr__(self):
		return repr((self.name, self.age))

# a list of custom objects
L = [Student('Sam', 35),
	Student('Tom', 25),
	Student('Bob', 30)]


x = min(L, key=lambda student: student.age)

print(x)
# Prints ('Tom', 25)