الفرق بين المراجعتين ل"Python/max"
| (مراجعتان متوسطتان بواسطة مستخدم واحد آخر غير معروضتين) | |||
| سطر 18: | سطر 18: | ||
مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن القابل للتّكرار المُعطى فارغًا. | مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن القابل للتّكرار المُعطى فارغًا. | ||
| − | إن كان الكائن القابل للتّكرار المُعطى فارغًا ولم تُمرّر قيمة للمُعامل <code>default</code>، فسيُطلق | + | إن كان الكائن القابل للتّكرار المُعطى فارغًا ولم تُمرّر قيمة للمُعامل <code>default</code>، فسيُطلق الاستثناء <code>[[Python/built-in exceptions#ValueError|ValueError]]</code>. |
== القيمة المعادة == | == القيمة المعادة == | ||
أكبر عنصر من العناصر المُعطاة. | أكبر عنصر من العناصر المُعطاة. | ||
| − | إن كان هناك أكثر من عنصر قصويّ واحد، فسيُعاد أولها. وهذا متوافق مع أدوات التّرتيب الحافظة للتّوازن (sort-stability preserving tools) مثل الطرّيقتين الآتيتين (انظر الدّالة <code>sorted</code> والوحدة <code>[[Python/heapq|heapq]]</code>): | + | إن كان هناك أكثر من عنصر قصويّ واحد، فسيُعاد أولها. وهذا متوافق مع أدوات التّرتيب الحافظة للتّوازن (sort-stability preserving tools) مثل الطرّيقتين الآتيتين (انظر الدّالة <code>[[Python/sorted|sorted]]</code> والوحدة <code>[[Python/heapq|heapq]]</code>): |
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
sorted(iterable, key=keyfunc, reverse=True)[0] | sorted(iterable, key=keyfunc, reverse=True)[0] | ||
| سطر 36: | سطر 36: | ||
>>> max([0, 2, 4, 3]) # قائمة | >>> max([0, 2, 4, 3]) # قائمة | ||
4 | 4 | ||
| − | >>> max([], default=0) # قائمة | + | >>> max([], default=0) # قائمة فارغة والقيمة الافتراضيّة هي صفر |
0 | 0 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== انظر أيضًا == | == انظر أيضًا == | ||
| − | |||
* [[Python/list|القوائم lists في بايثون]]. | * [[Python/list|القوائم lists في بايثون]]. | ||
| + | * الدالة <code>[[Python/min|min()]]</code>: تعيد أصغر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 13:00، 10 يونيو 2018
تعيد الدّالة max() أكبر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر.
البنية العامة
max(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل
max(arg1, arg2, *args[, key]) # مُعاملات منفردة
المعاملات
iterable
الكائن القابل للتّكرار المرغوب الحصول على أكبر عناصره.
key
مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة list.sort().
default
مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن القابل للتّكرار المُعطى فارغًا.
إن كان الكائن القابل للتّكرار المُعطى فارغًا ولم تُمرّر قيمة للمُعامل default، فسيُطلق الاستثناء ValueError.
القيمة المعادة
أكبر عنصر من العناصر المُعطاة.
إن كان هناك أكثر من عنصر قصويّ واحد، فسيُعاد أولها. وهذا متوافق مع أدوات التّرتيب الحافظة للتّوازن (sort-stability preserving tools) مثل الطرّيقتين الآتيتين (انظر الدّالة sorted والوحدة heapq):
sorted(iterable, key=keyfunc, reverse=True)[0]
heapq.nlargest(1, iterable, key=keyfunc)
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> max(0, 2, 4, 3) # معاملات مُتعدّدة
4
>>> max([0, 2, 4, 3]) # قائمة
4
>>> max([], default=0) # قائمة فارغة والقيمة الافتراضيّة هي صفر
0
انظر أيضًا
- القوائم lists في بايثون.
- الدالة
min(): تعيد أصغر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر.