الدالة cgi.escape()‎‎ في بايثون

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


تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف.


ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape()‎ عوضًا عنها.

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

cgi.escape(s, quote=False)

المعاملات

s

السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML.

quote

معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس المزدوجة (") إضافة إلى المحارف سابقة الذكر. تساعد عملية التحويل هذه في تضمين قيم خصائص HTML المحاطة بعلامة اقتباس مزدوجة، مثل ‎<a href="...">‎. يجدر التنبيه إلى أنّ الدالة لا تحوّل علامات الاقتباس المفردة على الإطلاق.

مصادر