الدالة urllib.parse.unquote() في بايثون
تحوّل الدالة الحروف المهرّبة بالصيغة %xx إلى الحروف الأصلية المكافئة لها.
البنية العامة
urllib.parse.unquote(string, encoding='utf-8', errors='replace')
المعاملات
string
السلسلة النصية المراد فكّ ترميزها.
encoding و errors
يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع bytes.decode().
يأخذ المعامل encoding القيمة الافتراضية 'utf-8'، أما المعامل 'errors' فيأخذ القيمة الافتراضية 'replace' والتي تعني أن التسلسلات غير الصالحة للاستخدام ستُستبدل بحروف أخرى.
أمثلة
يبين المثال التالي طريقة عمل الدالة:
>>> import urllib.parse
>>> urllib.parse.unquote('/El%20Ni%C3%B1o/')
'/El Niño/'
انظر أيضًا
- الدالة
urllib.parse.quote(): تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب%xx. - الدالة
urllib.parse.quote_plus(): هذه الدالة مشابهة للدالةquote() ولكنّها تستبدل المسافات الفارغة بعلامات+. - الدالة
urllib.parse.quote_from_bytes(): تشبه هذه الدالةُ الدالةَquote() ولكنّها تستقبل كائناتbytesعوضًا عن كائنات str، ولا تؤدي عمليات الترميز من السلاسل النصية إلى البايتات. - الدالة
urllib.parse.unquote_plus(): هذه الدالة مشابهة للدالةunquote() ولكنّها تستبدل علامات+بالمسافات البيضاء، وهذا هو المطلوب عند إلغاء الاقتباس من قيم نماذج HTML. - الدالة
urllib.parse.unquote_to_bytes(): تحول الدالة الحروف المهرّبة بالصيغة %xxإلى القيمة الثمانية المفردة المقابلة لها، وتعيد كائنbytes. - الدالة
urllib.parse.urlencode(): تحوّل الدالة كائن ربط mapping object أو تسلسلًا من صفوف ذات عنصرين، والتي قد تحتوي على كائناتstrأوbytesإلى سلسلة نصية مرمّزة بالنسبة المئوية ضمن الترميز ASCII.