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

من موسوعة حسوب
< Python‏ | cgi
اذهب إلى التنقل اذهب إلى البحث
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.


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


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

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

cgi.escape(s, quote=False)

المعاملات

s

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

quote

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

مصادر