دوال الكلاس set في بايثون

الكلاس set - الدالة isdisjoint() 

تعريف الدالة isdisjoint()

تقارن عناصر الـset الذي قام باستدعائها مع عناصر الـset الذي نمرره لها مكان الباراميتر anotherSet.
ترجع True إذا كانا لا يحتوان على عناصر قيمها متساوية. و ترجع False إن لم يكونا كذلك.



بنا الدالة isdisjoint()

set.isdisjoint(anotherSet)
  


باراميترات الدالة isdisjoint()

مكان الباراميتر anotherSet نمرر الـset الذي سيتم مقارنة عناصره مع عناصر الـset الذي قام باستدعائها.



قيمة ارجاع الدالة isdisjoint()

ترجع True إذا كان الـset الذي قام باستدعائها و الـset الذي مررناه لها لا يحتوان على عنصر واحد على الأقل قيمته متساوية.
غير ذلك ترجع False.


مثال عملي الدالة isdisjoint()

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف ثلاثة
      set1 = {1, 2, 3}
      set2 = {1, 7}
      set3 = {4, 5, 6}

      # لأنهما يحتويان على قيم متساوية False سترجع .set2 و set1 عند مقارنة عناصر الكائنين isdisjoint() هنا قمنا بعرض ما سترجعه الدالة
      print('set1 disjoint set2?', set1.isdisjoint(set2))

      # لأنهم لا يحتويان على قيم متساوية True سترجع .set3 و set1 عند مقارنة عناصر الكائنين isdisjoint() هنا قمنا بعرض ما سترجعه الدالة
      print('set1 disjoint set3?', set1.isdisjoint(set3))
    

سنحصل على النتيجة التالية عند التشغيل.

set1 disjoint set2? False
set1 disjoint set3? True

الكلاس set - الدالة issuperset() في بايثون

تعريف الدالة issuperset() تقارن عناصر الـset الذي قام باستدعائها مع عناصر الـset الذي نمرره لها مكان الباراميتر anotherSet.

ترجع True إذا كانت جميع عناصر الـset الذي نمرره لها مكان الباراميتر anotherSet موجودة في الـset الذي قام باستدعائها.
غير ذلك ترجع False.



بنا الدالة issuperset()

set.issuperset(anotherSet)
  


باراميترات الدالة issuperset()

مكان الباراميتر anotherSet نمرر الـset الذي سيتم مقارنة عناصره مع عناصر الـset الذي قام باستدعائها.



قيمة ارجاع الدالة issuperset()

ترجع True إذا كانت جميع عناصر الـset الذي نمرره لها مكان الباراميتر anotherSet موجودة في الـset الذي قام باستدعائها.
غير ذلك ترجع False.


المثال الأول في الدالة issuperset()

Test.py
# وضعنا فيهما أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3, 4, 5}
      set2 = {1, 2, 3}

      # set2 يحتوي على جميع عناصر set1 لأن True سترجع .set2 و set1 عند مقارنة عناصر الكائنين issuperset() هنا قمنا بعرض ما سترجعه الدالة
      print(set1.issuperset(set2))
    

سنحصل على النتيجة التالية عند التشغيل.

True


المثال الثاني في الدالة issuperset()

Test.py
# وضعنا فيهما أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3}
      set2 = {1, 2, 3, 4, 5}

      # set2 لا يحتوي على جميع عناصر set1 لأن False سترجع .set2 و set1 عند مقارنة عناصر الكائنين issuperset() هنا قمنا بعرض ما سترجعه الدالة
      print(set1.issuperset(set2))
    

سنحصل على النتيجة التالية عند التشغيل.

False

الكلاس set - الدالة issubset() في بايثون

تعريف الدالة issubset() تقارن عناصر الـset الذي قام باستدعائها مع عناصر الـset الذي نمرره لها مكان الباراميتر anotherSet.

ترجع True إذا كانت جميع عناصر الـset الذي قام باستدعائها موجودة في الـset الذي نمرره لها مكان الباراميتر anotherSet.
غير ذلك ترجع False.



بنا الدالة issubset()

                  set.issubset(anotherSet)
  


باراميترات الدالة issubset()

مكان الباراميتر anotherSet نمرر الـset الذي سيتم مقارنة عناصره مع عناصر الـset الذي قام باستدعائها.



قيمة أرجاع الدالة issubset()

ترجع True إذا كانت جميع عناصر الـset الذي قام باستدعائها موجودة في الـset الذي نمرره لها مكان الباراميتر anotherSet.
غير ذلك ترجع False.


المثال الأول في الدالة issubset()

Test.py
                    # وضعنا فيهما أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3}
      set2 = {1, 2, 3, 4, 5}

      # set1 يحتوي على جميع عناصر set2 لأن True سترجع .set2 و set1 عند مقارنة عناصر الكائنين issubset() هنا قمنا بعرض ما سترجعه الدالة
      print(set1.issubset(set2))
    

سنحصل على النتيجة التالية عند التشغيل.

True


المثال الثاني في الدالة issubset()

Test.py
                    # وضعنا فيهما أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3, 4, 5}
      set2 = {1, 2, 3}

      # set1 لا يحتوي على جميع عناصر set2 لأن False سترجع .set2 و set1 عند مقارنة عناصر الكائنين issubset() هنا قمنا بعرض ما سترجعه الدالة
      print(set1.issubset(set2))
    

سنحصل على النتيجة التالية عند التشغيل.

False

    الدالة clear () في بايثون

تعريف الدالة clear() تستخدم لحذف جميع عناصر الـset الذي قام باستدعائها.



بنا ؤها

set.clear()
  


باراميترات الدالة clear()

لا تقبل أي باراميتر.



قيمة الإرجاع

لا ترجع قيمة.


مثال في الدالة clear()

Test.py
# وضعنا فيه 5 عناصر aSet إسمه set هنا قمنا بتعريف
      aSet = {10, 20, 30, 40, 50}

      # aSet هنا قمنا بحذف جميع العناصر الموجودة في الكائن
      aSet.clear()

      # فارغ set و الذي سيظهر كـ aSet هنا قمنا بعرض ما يحتويه الكائن
      print('aSet contains:', aSet)
    

سنحصل على النتيجة التالية عند التشغيل.

aSet contains: set()

القيمة set() التي ظهرت في نتيجة التشغيل تعني أن الكائن aSet عبارة عن set فارغ لا يحتوي اي قيمة.

  الدالة copy () في بايثون

تعريفها ترجع نسخة من الـset الذي قام باستدعائها.



بناؤها

set.copy()
  


باراميترات الدالة copy()

لا تقبل أي باراميتر.



قيمة ارجاع الدالة copy()

ترجع نسخة من الـset الذي قام باستدعائها.


مثال على الدالة copy()

Test.py
# وضعنا فيه 5 عناصر set1 إسمه set هنا قمنا بتعريف
      set1 = {10, 20, 30, 40, 50}

      # set2 في الكائن set1 هنا قمنا بنسخ عناصر الكائن
      set2 = set1.copy()

      # set2 و set1 هنا قمنا بعرض ما يحتويه الكائن
      print('set1 contains:', set1)
      print('set2 contains:', set2)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

set1 contains: {40, 10, 50, 20, 30}
set2 contains: {50, 20, 40, 10, 30}

الكلاس set -  الدالة difference ()

تعريفها ترجع set جديد يحتوي على العناصر الموجودة في الـset الذي قام باستدعائها و الغير موجودة في كل set نمرره لها مكان الباراميتر sets*.



بناؤها

set.difference(*sets)
  


باراميترات الدالة difference()

مكان الباراميتر sets* نمرر كائن أو أكثر من النوع set مع الإشارة إلى أنه يجب وضع فاصلة بينهم عند تمرير أكثر من كائن.



قيمة الإرجاع

ترجع set جديد يحتوي على العناصر الموجودة في الـset الذي قام باستدعائها و الغير موجودة في كل set نمرره لها مكان الباراميتر sets*.


المثال الأول

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3, 4, 5}
      set2 = {1, 2, 3}

      # newSet و وضعناها في الكائن set2 و الغير موجودة في الكائن set1 هنا قمنا بإنشاء نسخة من العناصر الموجودة في الكائن
      newSet = set1.difference(set2)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {4, 5}


المثال الثاني

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف ثلاثة
      set1 = {1, 2, 3, 4, 5, 6}
      set2 = {1, 2}
      set3 = {3, 4}

      # newSet و وضعناها في الكائن set3 و set2 و الغير موجودة في الكائنين set1 هنا قمنا بإنشاء نسخة من العناصر الموجودة في الكائن
      newSet = set1.difference(set2, set3)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {5, 6}

    الدالة intersection()

تعريفها ترجع set جديد يحتوي على العناصر الموجودة في الـset الذي قام باستدعائها و في كل set نمرره لها مكان الباراميتر sets*.



بناؤها

set.intersection(*sets)
  


باراميترات الدالة intersection()

مكان الباراميتر sets* نمرر كائن أو أكثر من النوع set مع الإشارة إلى أنه يجب وضع فاصلة بينهم عند تمرير أكثر من كائن.



قيمة الإرجاع

ترجع set جديد يحتوي على العناصر الموجودة في الـset الذي قام باستدعائها و في كل set نمرره لها مكان الباراميتر sets*.

المثال الأول

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3, 4, 5}
      set2 = {1, 2, 3}

      # newSet و وضعناها في الكائن set2 و set1 هنا قمنا بإنشاء نسخة من العناصر الموجودة في الكائنين
      newSet = set1.intersection(set2)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {1, 2, 3}


المثال الثاني

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف ثلاثة
      set1 = {1, 2, 3, 4, 5, 6}
      set2 = {1, 2, 3, 4}
      set3 = {1, 2, 3}

      # مع عدم تكرار أي عنصر طبعاً newSet و وضعناها في الكائن set3 و set2 و set1 هنا قمنا بإنشاء نسخة من العناصر الموجودة في الكائنات
      newSet = set1.intersection(set2, set3)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {1, 2, 3}

 set -  الدالة pop () في بايثون

تعريفها تستخدم لإرجاع قيمة عنصر يتم إختياره بشكل عشوائي من الـset الذي قام باستدعائها, بعدها يتم حذفه منه.



بناؤها

set.pop()
  


باراميترات الدالة pop()

لا تقبل أي باراميتر.



قيمة الإرجاع

ترجع العنصر الذي تم حذفه من الـset.



أخطاء محتملة

ترمي الإستثناء TypeError في حال كان الـset فارغ.


مثال الدالة pop()

Test.py
# وضعنا فيه 5 عناصر aSet إسمه set هنا قمنا بتعريف
      aSet = {10, 20, 30, 40, 50}

      # و عرض قيمته aSet هنا قمنا باستخراج آخر عنصر موجود في الكائن
      print('Returned element:', aSet.pop())

      # aSet هنا قمنا بعرض العناصر المتبقية في الكائن
      print('Remaining elements:', aSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

Returned element: 40
Remaining elements: {10, 50, 20, 30}

 set -  الدالة remove () في بايثون

تعريفها تستخدم لحذف عنصر محدد من الـset الذي قام باستدعائها.



بناؤها

set.remove(elem)
  


باراميترات الدالة remove()

مكان الباراميتر elem نمرر كائن قيمته تطابق قيمة العنصر الذي نريد حذفه.



قيمة الإرجاع

لا ترجع قيمة.



أخطاء محتملة

ترمي الإستثناء KeyError في حال لم يتم إيجاد عنصر في الـset يملك نفس قيمة الكائن الذي مررناه مكان الباراميتر elem.


المثال الأول

Test.py
# وضعنا فيه مجموعة أعداد صحيحة aSet إسمه set هنا قمنا بتعريف
      aSet = {1, 2, 3, 4, 5}

      # aSet هنا قمنا بحذف العنصر الذي يملك القيمة 1 في الكائن
      aSet.remove(1)

      # aSet هنا قمنا بعرض ما يحتويه الكائن
      print(aSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

{2, 3, 4, 5}


المثال الثاني

Test.py
# وضعنا فيه مجموعة أعداد صحيحة aSet إسمه set هنا قمنا بتعريف
      aSet = {1, 2, 3, 4, 5}

      # عند التشغيل ValueError و بما أنه لا يوجد أي عنصر يملك هذه القيمة سيظهر الخطأ aSet لحذف عنصر يملك قيمة 10 في الكائن remove() هنا قمنا باستدعاء الدالة
      aSet.remove(10)

      # aSet هنا قمنا بعرض ما يحتويه الكائن
      print(aSet)
    

سنحصل على النتيجة التالية عند التشغيل.

KeyError: 10

 set -  الدالة symmetric_difference()

تعريفها ترجع set جديد يحتوي على العناصر الغير موجودة في كل من الـset الذي قام باستدعائها و في الـset الذي نمرره لها مكان الباراميتر anotherSet.



بناؤها

set.symmetric_difference(anotherSet)
  


باراميترات الدالة symmetric_difference()

مكان الباراميتر anotherSet نمرر الـset الذي سيتم مقارنة عناصره مع عناصر الـset الذي قام باستدعائها.



قيمة الإرجاع

ترجع set جديد يحتوي على العناصر الغير موجودة في كل من الـset الذي قام باستدعائها و في الـset الذي نمرره لها مكان الباراميتر anotherSet.


مثال الدالة symmetric_difference()

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3, 4, 5}
      set2 = {1, 2, 3}

      # newSet و وضعناها في الكائن set2 و set1 هنا قمنا بإنشاء نسخة من العناصر الغير موجودة في كل من الكائنين
      newSet = set1.symmetric_difference(set2)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {4, 5}

 set -  الدالة symmetric_difference_update()

تعريفها تقارن الـset الذي قام باستدعائها مع الـset الذي نمرره لها مكان الباراميتر anotherSet.

بعدها تضع في الـset الذي قام باستدعائها العناصر المشتركة بينهما فقط و تمسح أي عناصر آخرى كانت موجودة فيه.



بناؤها

set.symmetric_difference_update(anotherSet)
  


باراميترات الدالة symmetric_difference_update()

مكان الباراميتر anotherSet نمرر الـset الذي سيتم مقارنة عناصره مع عناصر الـset الذي قام باستدعائها.



قيمة الإرجاع

لا ترجع قيمة.


مثال الدالة symmetric_difference_update()

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 4, 5}
      set2 = {1, 2, 3, 5, 6, 7}

      # set1 في الكائن set2 و set1 هنا قمنا بوضع العناصر الغير مشتركة بين الكائنين
      set1.symmetric_difference_update(set2)

      # set1 هنا قمنا بعرض ما يحتويه الكائن
      print('set1 contains:', set1)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

set1 contains: {3, 4, 6, 7}

 set -  الدالة union()

تعريفها ترجع set جديد يحتوي على العناصر الموجودة في الـset الذي قام باستدعائها و العناصر الموجودة في كل set نمرره لها مكان الباراميتر sets*.



بناؤها

set.union(sets*)
  


باراميترات الدالة union()

مكان الباراميتر sets* نمرر كائن أو أكثر من النوع set مع الإشارة إلى أنه يجب وضع فاصلة بينهم عند تمرير أكثر من كائن.



قيمة الإرجاع

ترجع set جديد يحتوي على العناصر الموجودة في الـset الذي قام باستدعائها و العناصر الموجودة في كل الـset الذي نمرره لها مكان الباراميتر sets*.


المثال الأول

Test.py
# وضعنا فيهم أرقام صحيحة عشوائية set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3}
      set2 = {1, 2, 3, 4, 5}

      # مع عدم تكرار أي عنصر طبعاً newSet و وضعناها في الكائن set2 و set1 هنا قمنا بإنشاء نسخة من جميع العناصر الموجودة في الكائنين
      newSet = set1.union(set2)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {1, 2, 3, 4, 5}


المثال الثاني

Test.py
# وضعنا فيهم أرقام صحيحة عشوائية set هنا قمنا بتعريف ثلاثة
      set1 = {1, 2, 3, 5, 8, 7}
      set2 = {7, 2, 3, 5, 6, 1}
      set3 = {3, 4, 5, 8, 7, 9}

      # مع عدم تكرار أي عنصر طبعاً newSet و وضعناها في الكائن set3 و set2 و set1 هنا قمنا بإنشاء نسخة من جميع العناصر الموجودة في الكائنات
      newSet = set1.union(set2, set3)

      # newSet هنا قمنا بعرض ما يحتويه الكائن
      print('newSet contains:', newSet)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

newSet contains: {1, 2, 3, 4, 5, 6, 7, 8, 9}

الكلاس set -  الدالة update () في بايثون

تعريفها تقارن عناصر الـset الذي قام باستدعائها مع العناصر الموجودة في كل set نمرره لها مكان الباراميتر sets*.

بعدها تضع في الـset الذي قام باستدعائها العناصر المشتركة و الغير مشتركة بينهم.



بناؤها

set.update(*sets)
  


باراميترات الدالة update()

مكان الباراميتر sets* نمرر كائن أو أكثر من النوع set مع الإشارة إلى أنه يجب وضع فاصلة بينهم عند تمرير أكثر من كائن.



قيمة الإرجاع

لا ترجع قيمة.


المثال الأول

Test.py
# وضعنا فيهم أرقام صحيحة set هنا قمنا بتعريف إثنين
      set1 = {1, 2, 3}
      set2 = {1, 2, 3, 4, 5}

      # مع عدم تكرار أي عنصر طبعاً set1 في الكائن set2 و set1 هنا قمنا قمنا بوضع جميع العناصر الموجودة في الكائنين
      set1.update(set2)

      # set1 هنا قمنا بعرض ما يحتويه الكائن
      print('set1 contains:', set1)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

set1 contains: {1, 2, 3, 4, 5}


المثال الثاني

Test.py
# وضعنا فيهم أرقام صحيحة عشوائية set هنا قمنا بتعريف ثلاثة
      set1 = {1, 2, 3, 5, 8, 7}
      set2 = {7, 2, 3, 5, 6, 1}
      set3 = {3, 4, 5, 8, 7, 9}

      # مع عدم تكرار أي عنصر طبعاً set1 في الكائن set3 و set2 و set1 هنا قمنا قمنا بوضع جميع العناصر الموجودة في الكائنات
      set1.update(set2, set3)

      # set1 هنا قمنا بعرض ما يحتويه الكائن
      print('set1 contains:', set1)
    

سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل لأننا لا نعرف كيف سيتم ترتيب العناصر.

set1 contains: {1, 2, 3, 4, 5, 6, 7, 8, 9}
تعليقات