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