الدالة urllib.parse.unquote_plus()‎‎ في بايثون

من موسوعة حسوب
< Python‏ | urllib‏ | parse


هذه الدالة مشابهة للدالة unquote()‎ ولكنّها تستبدل علامات + بالمسافات البيضاء، وهذا هو المطلوب عند إلغاء الاقتباس من قيم نماذج HTML.

البنية العامة

urllib.parse.unquote_plus(string, encoding='utf-8', errors='replace')

‎المعاملات

string

السلسلة النصية المراد فكّ ترميزها.

encoding و errors

يحدّد هذان المعاملان الاختياريان طريقة فكّ ترميز التسلسلات المرمّزة بترميز النسبة المئوية إلى حروف يونيكود، وبنفس الطريقة المتّبعة في التابع bytes.decode()‎.

يأخذ المعامل encoding القيمة الافتراضية ‎'‎utf-8'‎، أما المعامل 'errors' فيأخذ القيمة الافتراضية 'replace' والتي تعني أن التسلسلات غير الصالحة للاستخدام ستُستبدل بحروف أخرى.

أمثلة

يبين المثال التالي طريقة عمل الدالة:

>>> import urllib.parse
>>> urllib.parse.unquote_plus('/El+Ni%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(): تحوّل الدالة الحروف المهرّبة بالصيغة ‎%xx إلى الحروف الأصلية المكافئة لها.
  • الدالة urllib.parse.unquote_to_bytes()‎: تحول الدالة الحروف المهرّبة بالصيغة ‎%xx إلى القيمة الثمانية المفردة المقابلة لها، وتعيد كائن bytes.
  • الدالة urllib.parse.urlencode(): تحوّل الدالة كائن ربط mapping object أو تسلسلًا من صفوف ذات عنصرين، والتي قد تحتوي على كائنات str أو bytes إلى سلسلة نصية مرمّزة بالنسبة المئوية ضمن الترميز ASCII.

مصادر