الفرق بين المراجعتين ل"Python/min"
(إضافة الصّفحة) |
|||
| (مراجعة متوسطة واحدة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>min()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>min()</code> في بايثون}}</noinclude> | ||
| − | تعيد الدّالة <code>min()</code> أصغر عنصر من عناصر كائن قابل للتّكرار أو | + | تعيد الدّالة <code>min()</code> أصغر عنصر من عناصر كائن قابل للتّكرار أو أصغر مُعامل من مُعاملين أو أكثر. |
== البنية العامة == | == البنية العامة == | ||
| سطر 18: | سطر 18: | ||
مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن القابل للتّكرار المُعطى فارغًا. | مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن القابل للتّكرار المُعطى فارغًا. | ||
| − | إن كان الكائن القابل للتّكرار المُعطى فارغًا ولم تُمرّر قيمة للمُعامل <code>default</code>، فسيُطلق | + | إن كان الكائن القابل للتّكرار المُعطى فارغًا ولم تُمرّر قيمة للمُعامل <code>default</code>، فسيُطلق الاستثناء <code>[[Python/built-in exceptions#ValueError|ValueError]]</code>. |
== القيمة المعادة == | == القيمة المعادة == | ||
| سطر 41: | سطر 41: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | |||
* [[Python/list|القوائم lists في بايثون]]. | * [[Python/list|القوائم lists في بايثون]]. | ||
| + | * الدالة <code>[[Python/max|max()]]</code>: تعيد أكبر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر. | ||
== مصادر == | == مصادر == | ||
| − | * [https://docs.python.org/3/library/functions.html# | + | * [https://docs.python.org/3/library/functions.html#min قسم الدالة min في صفحة Functions في توثيق Python الرسمي]. |
[[تصنيف:Python]] | [[تصنيف:Python]] | ||
[[تصنيف:Python Function]] | [[تصنيف:Python Function]] | ||
[[تصنيف:Python Built-in Functions]] | [[تصنيف:Python Built-in Functions]] | ||
المراجعة الحالية بتاريخ 13:02، 10 يونيو 2018
تعيد الدّالة 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
انظر أيضًا
- القوائم lists في بايثون.
- الدالة
max(): تعيد أكبر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر.