الفرق بين المراجعتين لصفحة: «Python/cgi/escape»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة <code>cgi.escape()</code> في بايثون}}</noinclude> تحوّل الدالة الحروف '&' و '>' و '<' في ال...' |
|||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة <code>cgi.escape()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة <code>cgi.escape()</code> في بايثون}}</noinclude> | ||
تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. | تحوّل الدالة الحروف <code>'&'</code> و <code>'>'</code> و <code>'<'</code> في [[Python/str|السلسلة النصية]] المعطاة إلى تسلسل حروف آمن في [[HTML]]. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. | ||
'''ملاحظة:''' هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape() عوضًا عنها. | '''ملاحظة:''' هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل <code>quote</code> يحمل قيمة خاطئة افتراضيًا. استخدم الدالة <code>[[Python/html/escape|html.escape()]]</code> عوضًا عنها. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 11: | سطر 11: | ||
cgi.escape(s, quote=False) | cgi.escape(s, quote=False) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | == المعاملات == | ||
=== <code>s</code> === | === <code>s</code> === | ||
السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML. | السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في [[HTML]]. | ||
=== <code>quote</code> === | === <code>quote</code> === | ||
معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس | معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس المزدوجة (<code>"</code>) إضافة إلى المحارف سابقة الذكر. تساعد عملية التحويل هذه في تضمين قيم خصائص [[HTML]] المحاطة بعلامة اقتباس مزدوجة، مثل <code><a href="..."></code>. يجدر التنبيه إلى أنّ الدالة لا تحوّل علامات الاقتباس المفردة على الإطلاق. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 17:41، 27 ديسمبر 2018
تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف.
ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape() عوضًا عنها.
البنية العامة
cgi.escape(s, quote=False)
المعاملات
s
السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML.
quote
معامل اختياري، إن أخذ قيمة صحيحة فإنّ الدالة ستحوّل علامات الاقتباس المزدوجة (") إضافة إلى المحارف سابقة الذكر. تساعد عملية التحويل هذه في تضمين قيم خصائص HTML المحاطة بعلامة اقتباس مزدوجة، مثل <a href="...">. يجدر التنبيه إلى أنّ الدالة لا تحوّل علامات الاقتباس المفردة على الإطلاق.