❮
Programming Basics SQL HTML CSS JavaScript React Python C++ Java JavaFX Swing Problem Solving English English Conversations Computer Fundamentals Linux Learn Typing
❯
عودة للدرس❯ ❮عودة للدرس

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

تعريفها

تبحث في الكائن الـdict الذي قام باستدعائها عن عنصر يملك نفس المفتاح الذي نمرره لها مكان الباراميتر key و في حال وجدته فإنها ترجعه و من ثم تحذفه منه.


بناؤها

dict.pop(key[, default])

باراميترات

  • مكان الباراميتر key نمرر مفتاح العنصر الذي نريد الحصول عليه.
  • defaultهو باراميتر إختياري، مكانه يمكن تمرير قيمة إفتراضية ليتم إرجاعها في حال لم يتم العثور على عنصر يملك المفتاح الذي مررناه لها.

قيمة الإرجاع

ترجع العنصر الذي تم حذفه من الـdict أو ترجع القيمة الإفتراضية التي تم تمريرها مكان الباراميتر default.


أخطاء محتملة

في حال لم يتم العثور على عنصر يملك المفتاح الذي تم وضعه مكان الباراميتر key و لم يتم وضع قيمة إفتراضية مكان الباراميتر default فإنها ترمي الإستثناء KeyError.


المثال الأول

Test.py 
# data يتألف من ثلاث عناصر, إسمه dict هنا قمنا بتعريف
data = {
    1: 'Admin',
    2: 'Editor',
    3: 'Reader'
}

# و من ثم عرضناه كما هو data هنا قمنا باستخراج العنصر الذي يملك المفتاح رقم 2 من الكائن
print('Returned element:', data.pop(2))

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

النتيجة

Returned element: (2, 'Editor')
Remaining elements: {1: 'Admin', 3: 'Reader'}

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

Test.py 
# data يتألف من ثلاث عناصر, إسمه dict هنا قمنا بتعريف
data = {
    1: 'Admin',
    2: 'Editor',
    3: 'Reader'
}

# و من ثم عرضناه كما هو data هنا حاولنا استخراج العنصر الذي يملك المفتاح رقم 5 من الكائن
# بما أنه لا يوجد عنصر يملك مفتاح يساوي الرقم 5 سيتم إظهار خطأ عند تشغيل البرنامج
print('Returned element:', data.pop(5))

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

النتيجة

print('Returned element:', data.pop(5))
KeyError: 5

المثال الثالث

Test.py 
# data يتألف من ثلاث عناصر, إسمه dict هنا قمنا بتعريف
data = {
    1: 'Admin',
    2: 'Editor',
    3: 'Reader'
}

# و من ثم عرضناه كما هو data هنا حاولنا استخراج العنصر الذي يملك المفتاح رقم 5 من الكائن
# بما أنه لا يوجد عنصر يملك مفتاح يساوي الرقم 5 و يوجد قيمة إفتراضية سيتم إرجاع القيمة الإفتراضية
print('Returned element:', data.pop(5, 'No item returned'))

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

النتيجة

Returned element: No item returned
Remaining elements: {1: 'Admin', 2: 'Editor', 3: 'Reader'}