Python内置函数(43)——min
英文文档:
min
(iterable, *[, key, default])
min
(arg1, arg2, *args[, key])
Return the smallest item in an iterable or the smallest of two or more arguments.
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.
If multiple items are minimal, the function returns the first one encountered. This is consistent with other sort-stability preserving tools such as sorted(iterable, key=keyfunc)[0]
and heapq.nsmallest(1, iterable, key=keyfunc)
.
说明:
1. 函数功能为取传入的多个参数中的最小值,或者传入的可迭代对象元素中的最小值。默认数值型参数,取值小者;字符型参数,取字母表排序靠前者。还可以传入命名参数key,其为一个函数,用来指定取最小值的方法。default命名参数用来指定最小值不存在时返回的默认值。功能与max函数相反。
2. 函数至少传入两个参数,但是有只传入一个参数的例外,此时参数必须为可迭代对象,返回的是可迭代对象中的最小元素。
>>> min(1) # 传入1个参数报错 Traceback (most recent call last): File "<pyshell#0>", line 1, in <module> min(1) TypeError: 'int' object is not iterable >>> min(1,2) # 传入2个参数 取2个中较小者 1 >>> min(1,2,3) # 传入3个参数 取3个中较小者 1 >>> min('1234') # 传入1个可迭代对象,取其最小元素值 '1'
3. 当传入参数为数据类型不一致时,传入的所有参数将进行隐式数据类型转换后再比较,如果不能进行隐式数据类型转换,则会报错。
>>> min(1,1.1,1.3e1) # 整数与浮点数可取最小值 1 >>> min(1,2,'3') # 数值与字符串不能取最小值 Traceback (most recent call last): File "<pyshell#5>", line 1, in <module> min(1,2,'3') TypeError: unorderable types: str() < int() >>> min([1,2],[1,3]) # 列表与列表可取最小值 [1, 2] >>> min((1,2),[1,3]) # 列表与元组不能取最小值 Traceback (most recent call last): File "<pyshell#7>", line 1, in <module> min((1,2),[1,3]) TypeError: unorderable types: list() < tuple()
4. 当存在多个相同的最小值时,返回的是最先出现的那个最小值。
#定义a、b、c 3个列表 >>> a = [1,2] >>> b = [1,3] >>> c = [1,2] #查看a、b、c 的id >>> id(a) 66486184 >>> id(b) 66486224 >>> id(c) 66486024 #取最小值 >>> d = min(a,b,c) >>> id(d) 66486184 #验证是否最小值是否是a >>> id(a) == id(d) True
5. 默认数值型参数,取值小者;字符型参数,取字母表排序靠前者;序列型参数,则依次按索引位置的值进行比较取最小者。还可以通过传入命名参数key,指定取最小值方法。
>>> min(1,2) # 取数值小者 1 >>> min('a','b') # 取排序靠前者 'a' >>> min('ab','ac','ad') # 依次按索引比较取较小者 'ab' >>> min(-1,-2) # 数值默认去数值较小者 -2 >>> min(-1,-2,key = abs) # 传入了求绝对值函数,则参数都会进行求绝对值后再取较小者 -1
6. key参数的另外一个作用是,不同类型对象本来不能比较取最小值的,传入适当的key函数,变得可以比较能取最小值了。
>>> min(1,2,'3') #数值和字符串不能取最小值 Traceback (most recent call last): File "<pyshell#22>", line 1, in <module> min(1,2,'3') TypeError: unorderable types: str() < int() >>> min(1,2,'3',key = int) # 指定key为转换函数后,可以取最小值 1 >>> min([1,2],(1,1)) #元组和列表不能取最小值 Traceback (most recent call last): File "<pyshell#24>", line 1, in <module> min([1,2],(1,1)) TypeError: unorderable types: tuple() < list() >>> min([1,2],(1,1),key = lambda x:x[1]) #指定key为返回序列索引1位置的元素后,可以取最小值 (1, 1)
7. 当只传入的一个可迭代对象时,而且可迭代对象为空,则必须指定命名参数default,用来指定最小值不存在时,函数返回的默认值。
>>> min(()) #空可迭代对象不能取最小值 Traceback (most recent call last): File "<pyshell#26>", line 1, in <module> min(()) ValueError: min() arg is an empty sequence >>> min((),default = 0) #空可迭代对象,指定default参数为默认值 0 >>> min((),0) #默认值必须使用命名参数进行传参,否则将被认为是一个比较的元素 Traceback (most recent call last): File "<pyshell#27>", line 1, in <module> min((),0) TypeError: unorderable types: int() < tuple()