الدالة cgi.escape()
في بايثون
تحوّل الدالة الحروف '&'
و '>'
و '<'
في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف.
ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote
يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape()
عوضًا عنها.
البنية العامة
cgi.escape(s, quote=False)
المعاملات
s
السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML.
quote
معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس المزدوجة ("
) إضافة إلى المحارف سابقة الذكر. تساعد عملية التحويل هذه في تضمين قيم خصائص HTML المحاطة بعلامة اقتباس مزدوجة، مثل <a href="...">
. يجدر التنبيه إلى أنّ الدالة لا تحوّل علامات الاقتباس المفردة على الإطلاق.