الدالة min() في بايثون
تعيد الدّالة min() أصغر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر.
البنية العامة
min(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل
min(arg1, arg2, *args[, key]) # مُعاملات منفردة
المعاملات
iterable
الكائن القابل للتّكرار المرغوب الحصول على أضغر عناصره.
key
مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة list.sort().
default
مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن القابل للتّكرار المُعطى فارغًا.
إن كان الكائن القابل للتّكرار المُعطى فارغًا ولم تُمرّر قيمة للمُعامل default، فسيُطلق استثناء ValueError.
القيمة المعادة
أصغر عنصر من العناصر المُعطاة.
إن كان هناك أكثر من عنصر دنويّ واحد، فسيُعاد أولها. وهذا متوافق مع أدوات التّرتيب الحافظة للتّوازن (sort-stability preserving tools) مثل الطرّيقتين الآتيتين (انظر الدّالة sorted والوحدة heapq):
sorted(iterable, key=keyfunc)[0]
heapq.nsmallest(1, iterable, key=keyfunc)
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> min(1, 2, 4, 3) # معاملات مُتعدّدة
1
>>> min([1, 2, 4, 3]) # قائمة
1
>>> min([], default=0) # قائمة فارغة والقيمة الافتراضيّة هي صفر
0