بايثونالدالة pop()
تعريفها
تبحث في كائن الـdict الذي قام باستدعائها عن العنصر الذي يملك نفس المفتاح الذي نمرره لها مكان الباراميتر key و من ثم تحذفه منه.
بناؤها
dict.pop(key[, default])
dict.pop(key[, default])
باراميترات
- مكان الباراميتر key نمرر مفتاح العنصر الذي نريد الحصول عليه.
- الباراميتر default هو باراميتر إختياري, يمكنك أن تمرر مكانه قيمة إفتراضية يتم إرجاعها فقط في حال لم يتم العثور على عنصر يملك المفتاح الذي مررناه لها مكان الباراميتر key.
قيمة الإرجاع
ترجع العنصر الذي تم حذفه من الـdict.
أو ترجع القيمة الإفتراضية التي تم تمريريها مكان الباراميتر default في حال لم يتم العثور على عنصر يملك المفتاح الذي مررناه لها مكان الباراميتر key.
أخطاء محتملة
في حال لم يتم العثور على المفتاح المراد حذف العنصر الذي يملكه و لم تمرر لها قيمة مكان الباراميتر default ترمي الإستثناء KeyError.
المثال الأول
# data يتألف من ثلاث عناصر, إسمه dict هنا قمنا بتعريف
data = {
1: 'Admin',
2: 'Editor',
3: 'Reader'
}
# و من ثم عرضناه كما هو data هنا قمنا باستخراج العنصر الذي يملك المفتاح رقم 2 من الكائن
print('Returned element:', data.pop(2))
# data هنا قمنا بعرض العناصر المتبقية في الكائن
print('Remaining elements:', data)
# 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'}
Remaining elements: {1: 'Admin', 3: 'Reader'}
المثال الثاني
# data يتألف من ثلاث عناصر, إسمه dict هنا قمنا بتعريف
data = {
1: 'Admin',
2: 'Editor',
3: 'Reader'
}
# و من ثم عرضناه كما هو data هنا حاولنا استخراج العنصر الذي يملك المفتاح رقم 5 من الكائن
# بما أنه لا يوجد عنصر يملك مفتاح يساوي الرقم 5, سيتم إظهار خطأ عند تشغيل البرنامج
print('Returned element:', data.pop(5))
# data هنا قمنا بعرض العناصر المتبقية في الكائن
print('Remaining elements:', data)
# 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
KeyError: 5
المثال الثالث
# 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)
# 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'}
Remaining elements: {1: 'Admin', 2: 'Editor', 3: 'Reader'}
